Docs on pkg.go.dev don't have preview tag set

[ansiwen]

The doc generation doesn't know that we use a preview tag, so all preview APIs are not documented there. We need to investigate, if we can set default tags for docs or something similar.

[phlogistonjohn]

Probably relevant: https://github.com/golang/go/issues/34409 https://github.com/golang/go/issues/45497

From what I see there's no easy way out. Options that are valid today are pretty limited. I wish the Go ecosystem liked static doc generation more, because then we could host our own version of the documentation with certain build tags enabled or a matrix of ceph version build tags, etc. But right now it seems that neither the official site works for this use case nor are there good offline doc generation tools for Go.

[phlogistonjohn]

More searching around wrt to the idea of generating static docs lead me to find https://github.com/readthedocs/godocjson and https://bitbucket.org/ymotongpoo/sphinxcontrib-golangdomain/src/master/ both of which look rather unmaintained. However, that doesn't necessarily mean they don't work. I haven't tried it.