go - 在 godoc 中添加标题

Question

我正在尝试在我的 godoc 中添加标题。我已经提到了 godoctricks。我的 godoc 如下所示：-

// Package hello-world provides a helloworld example
//
// Pre-requisites
//
//  * Go 1.5+
//  * Linux or MacOS
//  * https://onsi.github.io/ginkgo/ for executing the tests
//
//
package hello_world

但是 godoc 显示如下，前提条件不是标题：-

有人可以让我知道出了什么问题吗？

环境：-

• 去 1.7
• Mac OSX 埃尔卡皮坦

Answer 1

该列表似乎导致了问题。您可能想为此创建一个问题。

如果您在列出先决条件之前添加任何行，它将按预期工作：

// Package hello-world provides a helloworld example
//
// Pre-requisites
//
// You need to have the following:
//  * Go 1.5+
//  * Linux or MacOS
//  * https://onsi.github.io/ginkgo/ for executing the tests
//
//
package hello_world