在我工作三年多的经历中,发现身边同事的文档都有许多方面可以完善,但是他们自己好像并没有意识到需要完善。同时也有一些学弟学妹们咨询说,他们不清楚如何写一篇技术文档(方案),于是我就想着有时间了写一篇文章阐述一下要如何写一篇好的文档。
如果你上过研究生或者大学,读过论文(尤其是那些影响力很高的刊物的论文),就会发现其实最好的文档形式就是论文。如果论文不是一种规范、并且能够说明工作内容或者是解决问题的方法的形式,那么这种学术交流的形式也不会被沿用至今(历史上最早的研究期刊出版于17世纪)。
所以,如果让我用一句话阐述如何写好一篇文档,那么我的回答会是,像论文那样的结构写文档,是最好的形式。
知道了思路之后,下面我展开说明下如何写一篇文档。
1. 文档的种类
我们工作中接触的文档,一般有规划总结、产品方案、技术方案等。其实我能想到的常见的文档,都可以按照下面的形式展开,同时也会让读者很容易理解你想表述的内容。
2. 文档的结构
上面也说过了,我心中一篇好文档的要求,就是要以论文的结构展开阐述内容。
一般而言,论文有哪些结构呢?从我研究生期间读论文、写论文的经验看来,应该包括以下几个部分:
1)背景
在论文的开头,都会介绍相关问题的背景。比如为什么做这件事情,别人做类似事情的结果等。
2)相关内容(调研)
我个人理解,这个可以放到背景中,也可以单独拎出来,单独拎出来会更加清晰。此部分阐述目标主题包含哪几个方面或者解决问题需要用到的一些相关技术,或者介绍别人是如何解决此类问题。
3)正文(解决方案/步骤等)
介绍完了背景和相关调研之后,看文档的读者应该就了解了你的问题以及别人做类似事情的结果,同时也应该了解一些相关方案了。如果是技术方案,那就应该在这部分阐述不同模块或者方面的设计思路,同时用表格或者图片来帮助读者理解。如果是规划总结之类的文档,此部分应该是正式的内容以及拆解的任务等。
4)结论
当介绍完正文部分,就可以阐述结论或者证明自己的观点了。
5)总结及展望
此部分可以对比自己的结果与其他做过类似事情的人的结果的差异,提出做的好的方面以及可以完善的方面。同时可以展望相关事情未来可以朝什么方向发展或者努力。
6)参考资料
附上在完成这篇文档时读过的论文、其他文档、网页等信息。
3. 其他注意事项
1)可以将想要阐述的其他相关信息或者讨论列举在文档下方。
2)建议多用图表,这样便于读者理解内容。
3)建议将在文档的写作过程中帮助过你的人,以感谢的方式显示声明出来,这样即表明你是一个懂得感谢的人,也给帮助你的人做了一次宣传,他们值得这些宣传。
