今后技术写作的要求

来源:互联网 发布:linux ubuntu 安装gcc 编辑:程序博客网 时间:2024/04/29 17:26


          这里是一个分水岭。 

        -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------


          今后技术写作的要求:

               0.  对所要阐述的事物有透彻的认识及丰富的实践经历,深入事物核心与本质; 

               1.  每篇文章紧密围绕一个点, 务求说理透彻, 以充足论据为基础;

               2.  文笔生动, 简洁易懂, 娓娓道来, 脉络清晰;

               3.  写作是为了总结和分享知识和经验,探讨问题, 注重与读者互动;  

               4.  尽力提供准确、丰富的信息量;


           忌:

               1.   一知半解、不求甚解, 有一点肤浅的了解就急着动笔; 

               2.   掺杂浪费读者时间的无用碎语;


           写作之前的检测:

               1.   你真正透彻地理解其原理和内部机制了吗?

               2.   你的基本观点是什么? 有充足的示例来论证其观点吗?

               3.   有反面示例来表达相反的论点吗? 

               4.   有哪些文献可以参考? 已经做的工作?  还需要做的工作?  


               学会用简洁易懂的语言来表达自己所学到的知识、技能和想法。   

               从写好一篇技术文章开始。


 

原创粉丝点击