课程咨询: 400-996-5531 / 投诉建议: 400-111-8989
认真做教育 专心促就业
开发文档是每一位软件开发程序员在开发软件之前都需要准备的一个开发工具,而今天我们就通过案例分析来了解一下,软件开发文档都需要注意哪些问题。
1.永远不要假设
不要以为你知道的东西用户也知道,或者他们很清楚自己应该了解的内容。无论用户的熟练程度如何,总是从头开始解释各种事情是更好的选择。
2.遵守标准
在添加与代码内联的文档时,请使用代码编程语言所期望的标准。我们应该总是解释每个函数、变量以及函数返回的值都是什么意思。
3.图形元素
文档中应该多用图形元素,它们比文本更直观。这些媒介很有用,特别是当你使用图形界面构建软件时。你可以添加指向性元素,例如箭头、圆圈或任何可以帮助用户直观地弄清楚如何完成这些步骤的元素。
4.分区
你可以考虑将文档中的一些内容包装在项目符号列表和表格中,因为这样可以让用户更容易浏览较长的内容,更方便快速定位。
添加目录,并将文档拆分为一些容易理解的部分,同时要让各个部分与接下来的内容保持关联。内容应该简短明了。
5.修订和更新
文档写好后要仔细查看文档中是否有错误,并在必要时,或在产品、软件或库发生重大更改时修订文档。如果不随产品一起定期更新,那么你的文档对任何人都是没用的。
【免责声明】:本内容转载于网络,转载目的在于传递信息。文章内容为作者个人意见,本平台对文中陈述、观点保持中立,不对所包含内容的准确性、可靠性与完整性提供形式地保证。请读者仅作参考。更多内容请加danei0707学习了解。欢迎关注“达内在线”参与分销,赚更多好礼。