You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Problem: Currently, we're facing an issue with pkg.go.dev not recognizing our custom LICENSE, which is preventing the display of our project's generated documentation.
Solution: To work around this, we've decided to use the official godoc -http tool. We've laid the initial groundwork for this approach in this pull request: #884.
Next Steps:
Verify Generated Documentation: Since we're relying on a locally exposed HTTP server, there's a chance of broken links or inaccurate content in the generated documentation. Ensuring that the documentation is correct is essential.
Complete Configuration: We're in the process of finalizing the configuration to enable the display of the generated documentation, potentially through GitHub Pages.
Setting Up a Custom Domain: To make the documentation more accessible, we're considering setting up a custom domain name, which would make it easier to locate.
Related with #1046 (may want to use the same docs.gno.land URL?).
The text was updated successfully, but these errors were encountered:
Perhaps we could host this on a different subdomain; ie, pkg.gno.land in keeping with the Go documentation server theme (unless we plan on altering this theme) and then have higher-level documentation live on docs.gno.land. If this introduces confusion, we can easily just consolidate into docs.gno.land down the road.
We can also utilize an alternative to godoc, a tool called golds if we wished to customize formatting a bit further, otherwise we can stick to godoc if we wish the theme to be more in-keeping with Go.
I think it makes sense for the documentation of the gno repository to live on github.io. Maybe we should consider moving it if we want to move to being GitHub-agnostic in our import paths using vanity imports. (maybe something like src.gno.land for hosting the gno repo, or src.gno.land/gno); in which case that could take the godoc documentation.
In any case, the tool's been developed and works decently (IMO). We can iterate on that.
Problem: Currently, we're facing an issue with pkg.go.dev not recognizing our custom LICENSE, which is preventing the display of our project's generated documentation.
Solution: To work around this, we've decided to use the official
godoc -http
tool. We've laid the initial groundwork for this approach in this pull request: #884.Next Steps:
Verify Generated Documentation: Since we're relying on a locally exposed HTTP server, there's a chance of broken links or inaccurate content in the generated documentation. Ensuring that the documentation is correct is essential.
Complete Configuration: We're in the process of finalizing the configuration to enable the display of the generated documentation, potentially through GitHub Pages.
Setting Up a Custom Domain: To make the documentation more accessible, we're considering setting up a custom domain name, which would make it easier to locate.
Related with #1046 (may want to use the same docs.gno.land URL?).
The text was updated successfully, but these errors were encountered: