Похоже, что инструмент godoc
не Go модулей осведомлен.
Простой godoc -goroot=.
обслуживает файлы проекта, но не генерирует документацию для пакетов.Я проверил это в директории с исходными текстами проектов, где также хранятся файлы модулей go.mod
и go.sum
.
Как создать документацию для всех пакетов внутри модуля Go - за пределами $GOPATH
?
В примечаниях к выпуску Go 1.12 написано, что инструмент godoc
не будет включен в будущие выпуски Go и будет толькодоступно через go get
после Go 1.12 .Нужно использовать команду Go go doc
.Однако go doc
не генерирует «хорошие для чтения» HTML-страницы. Есть ли альтернатива для генерации документации из исходного кода Go, которая выводит HTML или Markdown?