tree: 0f8c3398ad1d7e999e19d2b88bc38cf2fc315048 [path history] [tgz]
  1. goldmark-codeblock/
  2. pkgload/
  3. testdata/
  4. .gitignore
  5. go.mod
  6. go.sum
  7. godocfx_test.go
  8. index.go
  9. index_test.go
  10. main.go
  11. parse.go
  12. README.md
  13. timesaver.go
internal/godocfx/README.md

Go DocFX YAML Generator

This tool generates DocFX YAML for Go modules.

Only a single module will be processed at once.

By default, the output files are stored at ./obj/api. You can convert them to HTML using doc-templates and/or doc-pipeline.

Example usage:

cd module && godocfx ./...
godocfx cloud.google.com/go/...
godocfx -print cloud.google.com/go/storage/...
godocfx -out custom/output/dir cloud.google.com/go/...
godocfx -rm custom/output/dir cloud.google.com/go/...

Testing

You can run the tests with go test.

If you need to update the golden files, add the -update-goldens flag:

go test -v -update-goldens