这是一个创建于 239 天前的主题，其中的信息可能已经有所发展或是发生改变。
本人已从事后端开发工作五六年了，在 AI （ Cursor..） 的辅助下，日常的代码开发、性能优化也算是能够得心应手了。
现在愈发觉得能否写好设计、对接文档才是展示个人能力的关键因素了，想听听大家对写好设计文档的看法和经验，包括但不限于好的文档结构和风格，流程图、时序图等开发经验、工具....
也欢迎分享一些优秀的设计文档。
分享下个人之前收藏的《 Google 技术写作》
 | 1 sakurawzt 239 天前 实际情况是，你写好了，前端不看，非要问你，还不如给他截图呢，哎。 |
 | 2 litchinn 239 天前 按照那些写的好的文档写啊当然是 |
 | 3 v1 239 天前 文档？那不是离职交接那个月才干的活吗？ |
 | 4 youyouzi 239 天前 别给自己加太多戏，前端根本不看的。。。你要是给领导看另说 |
 | 5 chendy 239 天前 一样，问问 AI 就行 然后你就会发现文档写出花也没卵用，不看的还不看，看不懂的还是看不懂，会找你问的还是会找你问 |
 | 8 zoharSoul 239 天前 随便写写拉倒 |
| 9 youyouzi 239 天前  1 @ryalu #6 为了应付开会，那就需求拆分，对每个需求点画泳道图，拆解功能点，写伪代码，写接口 api 路由，表结构，数据库字段，这种会应该每个人上去讲一讲，你写个 10 分钟内讲完的就行啊。 |
 | 10 Betsy 239 天前 via iPhone 1 https://arc42.org/overview 这里给了模板和样例 https://zh-style-guide.readthedocs.io/zh-cn/latest/ 这里给了写作风格指南 两个结合起来就是一篇合格的设计文档了 |
| 11 Betsy 239 天前 via iPhone 2 @Betsy 能把设计文档写清楚的人还是很厉害的， 能写他人之所想，想他人之未想； 知道哪些该写，哪些不该写（可能在评审的时候能被喷死）； 能准确表达自己的思想，准确向干系人传递设计方案 从经验来看，这个能做好的人，工程能力不会太差 |
 | 12 bxb100 239 天前  依照 2 年前我在 v 站的讨论, OpenAPI spec 先行的理论做法被一致批评 |
 | 13 qianji201712 239 天前 文档也让 cursor 来写就好了，不过前提是你后端代码清晰，设计比较好 |
 | &bsp; 14 Plutooo 239 天前 写完代码以后再用大模型逆推文档不应该更容易吗 |
 | 15 Granado 239 天前 我理解设计文档写好是必要的，也是基本的。要老板眼前一亮还是得有全局视角的规划，不限于业务规划、技术规划或者有明显的技术革新方案能提效降本。 |
 | 16 layxy 239 天前 只要后端开发完了文档就出来了(使用 ai 或者 swagger),不过这就涉及到一个争论点,先有文档还是先有接口? |
 | 17 NMmmm 239 天前 学学优秀的三方 SDK 怎么写文档的不就好了 |
 | 18 xiaohusky 239 天前 via iPhone 这个不算绩效啊，有什么用吗 |
Select Language