怎麼才能寫好技術文件

2021-04-09 06:17:46 字數 1048 閱讀 7986

有很多人都覺得我文件寫的好。這不是一兩個人說了。

我記得大概是在創業工作的時候,從寫業績點文件開始的。那時候,我自己給

做了一套模板。每次都按照這個格式寫。每次都能得到領導的好評。既把自己

的工作都寫進去了,還弄了個好名聲。

在東信工作的時候,我就是軟體組總體設計,專門寫設計文件。寫的還算好。

每個人都覺得寫的還算好。

有朋友說讓我介紹介紹經驗。那我就在這裡說說。其實,世上無難事,是怕

有心人啊。要做好一件事情,只要真心對待總能做好的,下面是關於寫文件

寫好文件,注意點有:

一、思路清晰、章節分布合理

分章節、逐層深入地描述問題。這是寫科技文件的要旨。看看msdn和各家

軟體公司的產品文件就可以知道,無一不是如此。

二、不用口語

科技說明文件,不用口語。不能出現「你們」、「我們」、「好啊」、

「咋樣啊」、「應該」。。。。。。這些都不能出現。比如,「應該」應

寫成「應」、「需」等書面用語。一些討論稿可以適量使用口語。

文件代表公司和技術要點,不是體現個人魅力的地方。乙個公司不能使用

五花八門風格的文件。口語的使用,更是會雪上加霜。

三、形成固定風格

科技文件不要求風格各異,但求達意簡約。這個和寫文章的方法是格格不入。

可以針對每類事務,形成固定的模板。所謂有章可循。要把它形成組織積累。

而不是個人行為。這樣能形成整體風格。

四、站在讀者的角度寫

主要涉及到難度、敘述方式等。文件敘述的難易程度要和讀者匹配。否則,

難了看不懂。太簡單了,也沒有意思。這些都沒有起到效果。

五、解決問題是核心

任何文件寫出來都是要解決問題,那就是幫助讀者熟悉知識點。任何的形式、

風格、注意點都是表面的東西。解決問題是關鍵。

乙個寫的再好的文件,不能姐姐問題,都是白搭。

六、注意積累

積水成淵、積善成德。任何事情都不是與生俱來的。小孩子出生後,如果馬上

就放到野獸的巢穴,也照樣說不了話。寫好文件也是如此。只有多寫,認真寫

才能寫好。 

如何才能寫出好的產品文件

一般來說,產品文件分為產品需求文件和產品使用文件兩種。產品需求文件主要面向的是產品的開發 設計者,期望是產品的實際開發人員了解產品的細節,讓開發完成的產品達到前期設計需求的預期 產品使用文件面向的主要是使用者,使其通過產品文件掌握產品的功能使用,也就是我們常說的產品使用幫助 如果不搞清楚文件面向的物...

抄完100個文案,終於能寫好文案了!

寫文案就像做一道數學題。數學高手一般是怎麼學習的?解題然後練習。數學教科書也是這麼編寫的,先理解範例,然後再去練習解題,最後考場才能得心應手。文案的學習方法也是如此,從模仿經典文案開始。做完 100 道題,就可以寫好文案了。程式設計客棧 休克文案shock id shockcw 1 提出新觀點 山葉...

怎麼寫好你的部落格(二)

前天發布了 ldqu怎麼寫好你的部落格系列 的第一篇,一些老博主可能會感覺沒新意,但確實是我的真實總結和心得。經過兩天的思考,今天就來講程式設計客棧講一些具有新意的創作方法。1 整合有價值的微博話語。作為乙個站長,你不可能沒有微博,而且不止乙個。挑選一些經典的 優秀的微博話語,自己的或者自己foll...