logo

drewdevault.com

[mirror] blog and personal website of Drew DeVault git clone https://hacktivis.me/git/mirror/drewdevault.com.git

godocs.io-six-months-later.md (1949B)


  1. ---
  2. title: godocs.io six months later
  3. date: 2021-05-07
  4. outputs: [html, gemtext]
  5. ---
  6. We're six months on from [forking godoc.org][0] following its upstream
  7. deprecation, and we've made a lot of great improvements since. For those
  8. unaware, the original godoc.org was replaced with pkg.go.dev, and a redirect was
  9. set up. The new website isn't right for many projects — one of the most
  10. glaring issues is the narrow list of software licenses pkg.go.dev will display
  11. documentation for. To continue serving the needs of projects which preferred the
  12. old website, we forked the project and set up [godocs.io](https://godocs.io).
  13. [0]: https://drewdevault.com/2020/12/18/godocs.io.html
  14. Since then, we've made a lot of improvements, both for the hosted version and
  15. for the [open source project][1]. Special thanks is due to Adnan Maolood, who
  16. has taken charge of a lot of these improvements, and also to a few other
  17. contributors who have helped in their own small ways. Since forking, we've:
  18. [1]: https://sr.ht/~sircmpwn/godocs.io/
  19. - Added Go modules support
  20. - Implemented [Gemini access](gemini://godocs.io)
  21. - Made most of the frontend JavaScript optional and simpler
  22. - Rewritten the search backend to use PostgreSQL
  23. We also substantially cleaned up the codebase, removing over 37,000 lines of
  24. code — 64% of the lines from the original code base. The third-party
  25. dependencies to Google infrastructure have been removed and it's much easier to
  26. run the software locally or on your intranet, too.
  27. What we have now is still the same GoDoc: the experience is very similar to the
  28. original godocs.org. However, we have substantially improved it: streamlining
  29. the codebase, making the UI more accessible, and adding a few important
  30. features; thanks to the efforts of just a small number of volunteers. We're
  31. happy to be supporting the Go community with this tool, and looking forward to
  32. making more (conservative!) improvements in the future. Enjoy!