GoDoc 里绝大部分包的文档都只是 API 列表，而没有使用 demo，或者quick start.
现在引用第三方包，就只能在源代码里跳来跳去，很难受啊，手动捂脸
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 3136 days ago, the information mentioned may be changed or developed.
 |
1
yangtukun1412 Oct 16, 2017  1
因为 godoc, 导致很多人喜欢写注释自动生成文档...最多再加几个 example.
|
 |
2
per Oct 16, 2017
赞同一楼的说法.毕竟我就是这样做的.😓
|
 |
3
legendlzy Oct 16, 2017
赞同 1 楼。。所以要找个方法简直难受
|
 |
4
zts1993 Oct 16, 2017
golang 第三方库质量不敢恭维，能自己写的建议自己造轮子。
|
 |
5
x8 Oct 16, 2017
golang 的嵌套层次远没有其他语言那么多，看源码没有其他语言那么痛苦，几个核心结构看一下差不多就了解个大概
如果一个第三方包写得又复杂，doc 又简陋，那就换个更好的，或者给它写黑盒测试，或者自己写轮子，或者忍着 这头像，要不是搜了图，差点认成我老婆 |
 |
7
gowk Oct 16, 2017
源代码即文档
|
 |
8
Morriaty OP @yangtukun1412
@per 文档并不一定要 Owner 去写啊，我是说目前的 Go 的新生军力量不小了，为什么就没有群策群力去维护文档？ 感觉还是社区习惯的问题，像 python，哪怕一个 100 stars 的库，基本都会有详尽的 quick start. |
 |
9
mason961125 Oct 16, 2017
@Morriaty 其实就是一楼说的，有 GoDoc 那么方便的平台，都不想再进一步的写了。不过一些 import 较多的库也都有很多的 examples 了，看看也能用。
|
 |
10
scofieldpeng Oct 16, 2017
有了 godoc 还需要啥文档，包开头简单说明下，扔一个小的例子，完事儿，看不懂？直接看源码呗，基本好一个质量不差的包每个 api 那儿都会有简单的说明，ps：golang 的官方包源码看起来也很爽
|
 |
11
reus Oct 16, 2017
godoc 够了，还不够就去看 *_test.go ，没有测试代码的就不要用
|
 |
12
janxin Oct 17, 2017 via iPhone
测试代码就是使用 demo，文档稍微写一下用法，我确实就是这样的，这样不需要写太多文档。
不过也确实对新入门不是特别友好，不过习惯了也没什么不一样。 |
 |
13
kuro1 Oct 17, 2017
因为有 godoc，自然就懒惰了...确实不太友好
|
 |
14
JamesRuan Oct 17, 2017
|
 |
15
mengzhuo Oct 17, 2017 via iPhone
楼上各位，Godoc 也可以加 example 的
|
Select Language