Golang 社区规模应该不算小了，为什么大部分第三方包的文档还是很简陋？

[Morriaty]

GoDoc 里绝大部分包的文档都只是 API 列表，而没有使用 demo，或者quick start.

现在引用第三方包，就只能在源代码里跳来跳去，很难受啊，手动捂脸

[yangtukun1412]

因为 godoc, 导致很多人喜欢写注释自动生成文档...最多再加几个 example.

[per]

赞同一楼的说法.毕竟我就是这样做的.😓

[legendlzy]

赞同 1 楼。。所以要找个方法简直难受

[zts1993]

golang 第三方库质量不敢恭维，能自己写的建议自己造轮子。

[lizon]

golang 的嵌套层次远没有其他语言那么多，看源码没有其他语言那么痛苦，几个核心结构看一下差不多就了解个大概

如果一个第三方包写得又复杂，doc 又简陋，那就换个更好的，或者给它写黑盒测试，或者自己写轮子，或者忍着

这头像，要不是搜了图，差点认成我老婆

[okletswin]

@lizon
哎码，猝不及防地装了一 B

[gowk]

源代码即文档

[Morriaty]

@yangtukun1412
@per

文档并不一定要 Owner 去写啊，我是说目前的 Go 的新生军力量不小了，为什么就没有群策群力去维护文档？

感觉还是社区习惯的问题，像 python，哪怕一个 100 stars 的库，基本都会有详尽的 quick start.

[mason961125]

@Morriaty 其实就是一楼说的，有 GoDoc 那么方便的平台，都不想再进一步的写了。不过一些 import 较多的库也都有很多的 examples 了，看看也能用。

[scofieldpeng]

有了 godoc 还需要啥文档，包开头简单说明下，扔一个小的例子，完事儿，看不懂？直接看源码呗，基本好一个质量不差的包每个 api 那儿都会有简单的说明，ps：golang 的官方包源码看起来也很爽

[reus]

godoc 够了，还不够就去看 *_test.go ，没有测试代码的就不要用

[janxin]

测试代码就是使用 demo，文档稍微写一下用法，我确实就是这样的，这样不需要写太多文档。

不过也确实对新入门不是特别友好，不过习惯了也没什么不一样。

[kuro1]

因为有 godoc，自然就懒惰了...确实不太友好

[JamesRuan]

自认为文档还是很完善的： https://github.com/jamesruan/sodium

文档不完善其实就是习惯不好没写呗：）

[mengzhuo]

楼上各位，Godoc 也可以加 example 的