如何提高自己的文档输出能力

[cobainlu]

最近因为工作的原因需要经常给甲方一些接口 /数据标准的文档.每次写总觉得自己在代码之外输出这些文档的能力很薄弱,参考了一些开源项目的文档,也没有得到很好地启发,各位 v 友在工作中有遇到这些问题吗?

[Qsong]

一个字，熟能生巧

[WilsonGGG]

作为 PM ，我的建议就是：
1. 先找一份标准文档，比方说飞书里面可能有这种模板
2. 根据习惯和内容密度，给模板删去 /增加一些内容
3. 然后开始写，写个三五份；写的过程中你会发现很多这个模板不足 /不合适的地方。
4. 每次写完重新读一遍，看看结构，这里不用太一本正经，就是小小的回顾即可
5. 等你写完三五份，有了一些感悟和反馈之后，要写啥基本心里有数了
6. 后面就可以去看一些别人的教程、分享，融入到自己的模板中
7. 如果你比较讲究，可以开一个文档 /思维导图记录下你自己的文档结构，随取随用

P.S. 新手最忌讳的就是上来就搞一堆教程，你的脑子里没概念，吃的东西消化不了，很容易越搞越烂。先从最无脑 /普适的开始，练个五六次，结构啊内容啊可以改善的啊，基本有数了，这时候再去看别人的教程，你也能大概知道别人的水平，哪些能用哪些不能。

[kujio]

我们公司的产品文档就像初中生写的说明书,(虽然我也不会写)

[akira]

接口文档只要把接口说清楚就可以了

[star7th]

你注册一个 showdoc 账户， 然后看看其生成的系统文档示例 https://www.showdoc.com.cn/ 。然后根据模板的框架去描述就好。一般情况下都能明白。特殊业务特殊说明。

[cairnechen]

一个比较好的案例？
https://stripe.com/docs/api

[waltcow]

github copilot

[statement]

肯定是找一份文档改

[keshawnvan]

写文档考验的是精准表达能力，需要多练一练。

[ila]

swagger

[461da73c]

文档的好坏不是很好评判，有些人写的文档，看着洋洋洒洒，都是长句，读起来非常费劲。有些人写的短句口语化较多，读起来又不太严肃。

[balabalaguguji]

用易文档写吧，看看多专业 https://easydoc.net/s/17790664/CZMqMhfW/78558034

[reallittoma]

Github Copilot 是正确答案

[rpman]

Copilot YYDS
等着出正式版时打钱了