tree: 5144a0bff472bfa3a451a0f15dfbcdbbe7a47b0a [path history] [tgz]
  1. .gitignore
  2. README.md
  3. go.mod
  4. go.sum
  5. godocfx_test.go
  6. index.go
  7. index_test.go
  8. main.go
  9. parse.go
  10. testdata/
  11. 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