~sircmpwn/godocs.io

1

Versions issues

Details
Message ID
<cdb6609b4b4f9b2950473c910f97ae9e56e70f2e.camel@gmail.com>
DKIM signature
pass
Download raw message
This is a great tool, thanks for hosting it.

I noticed two issues:

(PS: I'm not subscribed to this list so please CC-me on any
correspondence.)

1) You can't seem to display the git `master` or `main` versions of
things. For example:

https://godocs.io/github.com/google/nftables?view=versions

This package has a newer "unreleased" `main` branch which is more
useful. Not sure why modern "pkg.go.dev" site doesn't show it either.

2) Some packages don't show any versions, despite having many. I
suspect this is some bug about how things determine what a version is.
If you know the heuristic, please let me know, I will update things.
For example:

https://godocs.io/github.com/purpleidea/mgmt?view=versions

This package has a bunch of released tags.

Thanks for your great work!
Cheers,
James
Details
Message ID
<CZQ1A4W91ZIH.1P5RX0XN3BSHV@maolood.com>
In-Reply-To
<cdb6609b4b4f9b2950473c910f97ae9e56e70f2e.camel@gmail.com> (view parent)
DKIM signature
pass
Download raw message
On Sat Mar 9, 2024 at 6:59 PM EST, James wrote:
> This is a great tool, thanks for hosting it.

Glad you like it!

> 1) You can't seem to display the git `master` or `main` versions of
> things. For example:
>
> https://godocs.io/github.com/google/nftables?view=versions
>
> This package has a newer "unreleased" `main` branch which is more
> useful. Not sure why modern "pkg.go.dev" site doesn't show it either.

Yes, this is currently unimplemented. godocs.io currently fetches modules once
and caches them indefinitely. This assumption breaks when using the master or
main branch, which may need to be updated all the time.

> 2) Some packages don't show any versions, despite having many. I
> suspect this is some bug about how things determine what a version is.
> If you know the heuristic, please let me know, I will update things.
> For example:
>
> https://godocs.io/github.com/purpleidea/mgmt?view=versions
>
> This package has a bunch of released tags.

Versions must start with a 'v' prefix. See also:
https://go.dev/ref/mod#versions
Reply to thread Export thread (mbox)