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 (1924B)


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