最近在纠结产品文档的撰写,文档写的详细点吧,有点罗嗦,写的简单些呢,就感觉内容不够,怕用户神马其他人看不懂...所以决定,先写多点,再在其中选择一些不必要的话去删减!(好方法)
额,还发现,学好小学语文很重要的了!关于书面语和口语的问题,必须必须得好好斟酌的呀!
文档给不同的人看,貌似有不同的书写方法呢!如有PPT,白皮书,用户手册等一系列的东西呀!不仅偏重点不一样呀,而且那个用语和语气也不一样的呀!写的时候还要想着这个是写个谁的,假想对象....
还要弄清楚很多的概念,让我这纯粹的理科生情何以堪!如功能与特性的区别,功能讲能干什么,需要全面(详略体现的深入/细化的程度,而非覆盖范围),特性讲好在哪,需要抓关键有时区别不是很绝对,但每一类要有一致性和平衡性。文档的作用是“怎么用”,文档不是白皮书,不是用来讲“好在哪”,文档不是教程,不是step by step的学习指南等等等。
大家慢慢体会吧,相信写的多了,语文水平就呼呼呼的往上涨了滴....