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