jgoerz / hugo-docsy-simple

Motivation

Hugo and Docsy make an excellent pairing for simple to maintain and publish documentation. Use this to get started.

Prequisites

• Install go
• Install hugo

# I think this is simplest once you have go installed
go install -tags extended github.com/gohugoio/hugo@latest

Build it

1. Clone it.
2. rm go.mod go.sum
3. hugo mod init example.com/docs
4. hugo mod get github.com/google/docsy@v0.6.0
5. hugo mod tidy
6. npm install
7. hugo server

Next steps: https://www.docsy.dev/docs/adding-content

References

• https://github.com/gwatts/mostlydocs
• https://www.docsy.dev/
• https://github.com/OAI/OpenAPI-Specification/tree/main/examples/v3.0