这么多年终于理解程序员为什么不喜欢写文档的原因

下面是今天在一篇文章中看到,终于理解程序员为什么不喜欢写文档的原因。


文中开理由如下:


英文:

  • If it’s not code, it can’t be run through a compiler to make sure it makes sense.
  • If it’s not code, it doesn’t get executed, so it may never be used to accomplish anything.
  • If it’s not code, it can’t have tests against it, so there’s no way to prove that it is truthful and correct.
  • Agile even de-emphasized documentation in the Manifesto: Working software over comprehensive documentation.


中文:
如果不是代码,它就无法通过编译,也无法确定它是不是有意义
如果不是代码,它就无法执行,所以可能永远无法用于完成任何事情。
如果不是代码,也就无法对它进行测试,因此也无法证明它的真实与正确
敏捷宣言中甚至都不再强调文档:可以工作的软件胜过面面俱到的文档。


当然这只是引言了,如果要看全文请通过下面这个连接。

http://www.infoq.com/articles/id-rather-be-coding-writing-things-down




  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
技术文档程序员工作中非常重要的一部分,下面是一些建议来帮助你技术文档: 1.明确目标受众:确定你的文档是面向其他开发人员、经理、客户还是非技术人员。这有助于你选择合适的语言和术语,并确保你的文档能够满足读者的需求。 2.使用清晰简洁的语言:避免使用过于复杂的术语和缩,尽量使用通俗易懂的语言来解释技术概念。如果必须使用特定术语,确保在文档中提供清晰的解释和定义。 3.结构化和组织良好:将文档分成几个部分,例如介绍、使用指南、API文档等。使用标题、段落和列表来组织内容,以便读者可以轻松地找到所需信息。 4.提供示例代码和截图:在文档中提供具体的示例代码和截图,这有助于读者理解技术概念和步骤。确保示例代码准确、可运行,并附带适当的注释。 5.使用图表和图像:使用图表和图像来说明复杂的流程、架构或数据关系。这些图像可以帮助读者更好地理解和记忆文档中的信息。 6.更新和维护:技术文档应该与软件的版本保持同步,并定期进行更新和维护。确保删除或更新过时的信息,并添加新的功能和变更。 7.注重用户反馈:接受用户的反馈和建议,并根据需要对文档进行改进。这有助于提高文档的质量和可理解性。 最后,记住技术文档是一项技能,需要不断的实践和改进。随着经验的积累,你会变得更加熟练并能够编出高质量的技术文档

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值