跳至主要內容
  • Hostloc 空間訪問刷分
  • 售賣場
  • 廣告位
  • 賣站?

4563博客

全新的繁體中文 WordPress 網站
  • 首頁
  • 写文档比写代码难多了
未分類
2020 年 9 月 8 日

写文档比写代码难多了

写文档比写代码难多了

資深大佬 : heboy 0

最近计划开源一个项目,功能很简单总共就 3 个命令加一些扩展,结果文档写了两个月还是不满意,删了写写了删。真的比写代码还纠结

大佬有話說 (16)

  • 資深大佬 : wysnylc

    文字的历史比代码可久多了

  • 資深大佬 : rimutuyuan

    写文档还好,写解决方案才费劲,想起了被 800 字支配的恐惧

  • 資深大佬 : redbuck

    找下有没有自动生成的方案.

  • 資深大佬 : iMiata

    上家公司基本所有项目的文档基本都是我给补齐的,亲身体会是写文档用英文比中文简单

  • 主 資深大佬 : heboy

    @iMiata 哈哈我也觉得,英文的反而好写,可能是我英文词汇量少不用纠结

  • 資深大佬 : shifttacn

    工作内容一大部分是看别人的代码,然后写文档。
    看别人代码才是最难的。

  • 資深大佬 : iMiata

    其实主要是编程整个一套知识体系都是舶来品,用英文描述相对比中文更准确(也是水平还不够,没法用中文准确描述哈哈)

  • 資深大佬 : raaaaaar

    看什么文档吧,复杂点的程序,如果文档没写好,程序质量也不会太高。

  • 資深大佬 : wangkun025

    代码也是英文的,所以……

  • 資深大佬 : iConnect

    有些复杂度高的代码,100 行不到,半天看不明白也很常见

  • 資深大佬 : IGJacklove

    文档先写个大概的被,有问题可以等别人 pr 或根据具体问题补充

  • 資深大佬 : cassyfar

    一个好的代码,不需要文档,因为他有自述性(狗头

  • 資深大佬 : hoyixi

    你这是使用文档吧,设计文档更显技术,好的设计文档,放在那里,拉几个人立刻就能重新做出来

  • 主 資深大佬 : heboy

    @hoyixi 没错,是使用文档

  • 資深大佬 : wzzzx

    我也觉得文档难写,说人话是真的好难 写文档比写代码难多了 写文档比写代码难多了 写文档比写代码难多了

  • 資深大佬 : Cielsky

    @wzzzx 说人话确实难哈哈

文章導覽

上一篇文章
下一篇文章

AD

其他操作

  • 登入
  • 訂閱網站內容的資訊提供
  • 訂閱留言的資訊提供
  • WordPress.org 台灣繁體中文

51la

4563博客

全新的繁體中文 WordPress 網站
返回頂端
本站採用 WordPress 建置 | 佈景主題採用 GretaThemes 所設計的 Memory
4563博客
  • Hostloc 空間訪問刷分
  • 售賣場
  • 廣告位
  • 賣站?
在這裡新增小工具