Set up godoc server #29

Open
opened 2022-05-26 14:49:16 +00:00 by bvisness · 0 comments
Owner

I would like to use the Go documentation system for technical documentation of the website codebase. I've already documented the db package in some detail, and I'd like to do others too. However, we looked into using pkg.go.dev and I don't think it will really work, because it requires us to license our code in a particular way (a step we're not ready to take), and it requires updated versions of our code to be stored in the Go package index / proxy, which really only happens if people are running go get on our code (and they do not ever do this).

We should run a custom godoc server at godoc.handmade.network for this purpose. It can probably just run off our Git server, I guess?

I would like to use the Go documentation system for technical documentation of the website codebase. I've already documented the `db` package in some detail, and I'd like to do others too. However, we looked into using pkg.go.dev and I don't think it will really work, because it requires us to license our code in a particular way (a step we're not ready to take), and it requires updated versions of our code to be stored in the Go package index / proxy, which really only happens if people are running `go get` on our code (and they do not ever do this). We should run a custom godoc server at godoc.handmade.network for this purpose. It can probably just run off our Git server, I guess?
bvisness added the
admins only
label 2022-05-26 14:49:21 +00:00
Sign in to join this conversation.
No Milestone
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: hmn/hmn#29
No description provided.