代码文档和用户文档之间的区别

代码文档和用户文档之间的区别

如何打包你的 LaTeX 包教程:

“软件包的重要部分是代码、代码文档和用户文档。”

代码文档和用户文档有什么区别?

答案1

好吧,尽管 jjdb 击中了要点:

用户文档 = 用户指南,代码文档 = 程序员指南

我尝试说得更诗意一些:

用户指南,顾名思义,它旨在供用户使用,即坐在计算机后面并使用您的代码做任何他需要做的事情的人。

文档代码是程序员遵循的良好实践的一部分,目的是跟踪他正在做的事情,为任何想要接触代码的人留下清晰的信息,并保持他的头脑清醒(特别是在长时间没有与代码交互后回来时)。

基本上,用户文档应该尽可能地具有解释性,因为您不知道阅读它的人对包的理解程度如何(请记住,如果这是第一个版本,很可能没有人见过它),而代码文档应该以演示您的代码正在做什么以及在哪里执行为导向,以便尽可能轻松地进行任何修改。

相关内容