Announcing godocs.io, a maintained fork of godoc.org

313 views
Skip to first unread message

Drew DeVault

unread,
Jan 20, 2021, 6:03:01 PM1/20/21
to golan...@googlegroups.com
Greetings. For those who do not wish to follow Golang to pkg.go.dev, and
prefer the authentic godoc.org experience, I have forked the gddo
codebase and set up an instance which will be maintained indefinitely:

https://godocs.io

The source code is available here:

https://sr.ht/~sircmpwn/godocs.io

With the help of some volunteers, we have already made modest,
conservative improvements to godoc.org. Some features have been
updated to work with JavaScript disabled, dead links and obsolete tools
have been pruned, and our fork should be easier to use on your intranet
after we trimmed it of many Google-specific parts. We have also removed
all of the previously included surveillance software, such as Google
Analytics.

We plan on introducing first-class support for Go modules, which is the
main functional difference which distinguishes pkg.go.dev from
godoc.org. We also do not plan on making similar breaking changes with
respect to enforcing the use of a Google-approved license or licensing
conventions. We will also not be asking contributors to sign a CLA to
contribute.

Otherwise, we intend to make only changes which keep it in good working
order as a useful tool for Go users.

Enjoy!

Nick

unread,
Jan 21, 2021, 6:00:33 AM1/21/21
to golan...@googlegroups.com
Hi Drew,

Quoth Drew DeVault:
> With the help of some volunteers, we have already made modest,
> conservative improvements to godoc.org. Some features have been
> updated to work with JavaScript disabled, dead links and obsolete tools
> have been pruned, and our fork should be easier to use on your intranet
> after we trimmed it of many Google-specific parts. We have also removed
> all of the previously included surveillance software, such as Google
> Analytics.

Cool, sounds good, no surveillance and a user experience that
doesn't expect javascript enabled are always good! First impressions
are that it's fast, simple and useful.

> We plan on introducing first-class support for Go modules, which is the
> main functional difference which distinguishes pkg.go.dev from
> godoc.org.

Excellent, I look forward to seeing the module support added.

I tend to just use 'go doc' on the command line, but being able to
browse documentation for packages I haven't yet is great. Also 'go
doc' still doesn't seem to support Examples yet (which I need to get
around to reporting on the issue tracker, and maybe fixing myself!)

Thanks!

Sebastien Binet

unread,
Jan 22, 2021, 12:38:18 PM1/22/21
to Drew DeVault, golan...@googlegroups.com
hi,

On Wed Jan 20, 2021 at 23:44 CET, Drew DeVault wrote:
> Greetings. For those who do not wish to follow Golang to pkg.go.dev, and
> prefer the authentic godoc.org experience, I have forked the gddo
> codebase and set up an instance which will be maintained indefinitely:
>
> https://godocs.io
>
> The source code is available here:
>
> https://sr.ht/~sircmpwn/godocs.io

nice.

do you plan on also providing a Gemini end-point for godocs.io ?

-s

Drew DeVault

unread,
Jan 22, 2021, 12:38:36 PM1/22/21
to Sebastien Binet, golan...@googlegroups.com
On Fri Jan 22, 2021 at 12:37 PM EST, Sebastien Binet wrote:
> do you plan on also providing a Gemini end-point for godocs.io ?

No, but patches welcome.
Reply all
Reply to author
Forward
0 new messages