用戶手冊是作者經過實踐活動形成的經驗。包括實踐過程中所有的記錄,正確的,或者錯誤的。用戶手冊應該分為兩部分,經驗與理論。 經驗不是指實踐的過程,應該是實踐的結果。用戶不需要經歷作者的實踐活動,他們需要的是能夠直接指導其開始FreeNAS伺服器設置的工作。用戶不需要知道一步一步的做什麼,需要的是我有一 ...
用戶手冊是作者經過實踐活動形成的經驗。包括實踐過程中所有的記錄,正確的,或者錯誤的。用戶手冊應該分為兩部分,經驗與理論。
經驗不是指實踐的過程,應該是實踐的結果。用戶不需要經歷作者的實踐活動,他們需要的是能夠直接指導其開始FreeNAS伺服器設置的工作。用戶不需要知道一步一步的做什麼,需要的是我有一個要求,如何通過理論實現這個要求。 經驗,用戶手冊的第一部分是作者實現自身要求的最簡單的經歷。 用戶作者想保存一些照片、音頻與電子圖書資料。照片、視頻只能有作者或者妻子上傳,或者把保存在伺服器上的照片與視頻刪除。孩子與作者的父母親只能瀏覽照片,播放視頻的操作。編程方面的圖書只需要用戶作者上傳與讀寫。其他人無任何訪問的許可權。妻子有自己的私密照片,只有作者與妻子兩個人可以上傳與查看。孩子或者作者的父母瀏覽照片,播放視頻的時候不需要輸入密碼,只要聯接伺服器就可以操作。 作者想增加一個保存自己文章的文件夾。這個文件夾只屬於作者自己。其他任何人不能共用。如果有朋友來到家裡,可以查看瀏覽指定的照片或者播放視頻。所有到來的朋友是否可以自動瀏覽共用指定的數據。要求登錄方便,不需要複雜的操作。 可以通過網路盒子在電視機上瀏覽照片,播放視頻。手機(安桌或蘋果)、電腦(台式機或者筆記本),都可以共用上傳資料數據。 用戶手冊首先是一個實例場景,是手冊作者實現自身要求並經過實踐檢驗的行為活動。然後是理論部分。這部分應該有綜合有分析,按照場景中的要求提供各種理論的指導工作。簡單說,場景中有一個要求建立私有的文檔資料文件夾。這是怎麼實現的呢?對於任何建立這種要求的操作,都具有共同的屬性與方法,或者說操作步驟。 理論就是把場景中的特殊性上升為普遍性。用戶根據場景中的要求,找到自己的如何操作的設置的。如果用戶的要求沒有出現在場景中,那麼用戶可以根據自己的特殊要求,通過對理論的綜合與分析,找到解決自己問題的辦法。 所以用戶手冊中場景的設計要儘可能的全面,這些場景不能是作者自己想象出來的,而是從網路上收集不同的用戶的需求。把大數人不同需要,分門別類的綜合與分析。找出各種需要之間的共性。把這種共性設計在場景中。 作者通過實踐活動實現了場景中的要求,也即實現了現實生活中部分用戶的要求。從實踐的活動中,作者不斷的抽象,也即由具體轉化為抽象,綜合分析得到共性的東西,這就是理論的普遍性意義。 如何的從場景中的特殊性上升為理論的為普遍性?作者在場景中要建立一個私有的保存自己文章的文件夾。只能自己上傳讀寫操作。從特殊性來說這是保存私有的文章。從普遍性來說,保存私有的照片、視頻、任何私有的文件都是如此的操作。 從特殊性來說,文件夾中保存著的是文章。從普遍性的意義來說,只要把文件夾的許可權共用方式設置正確,那麼這個文件夾可以保存任何形式的私有文件。那麼在這裡得到的理論之一:建立一個可以保存任何形式的私有共用的文件夾的方法是什麼呢? 對於這個理論,繼續的進行分析。用戶、文件夾、許可權、共用,這四個內容是對於所有操作抽象。也就是說場景中的內容,最終可以歸結為上述四項內容的抽象。也即編程語言所說的類,類是沒有實例化的對象。對象是具有具體屬性數據的類。類與對象的區別在於屬性而非方法。類中會有一些虛的方法,也即只有名稱,沒有行為的方法過程。繼承的類,可以對這些父類中的虛的過程進行具體的行為操作。 數據文件伺服器的行為,無外乎上述四種操作的組合。也即用戶、文件夾、許可權、共用基本的磚頭,所有的功能都是這些磚頭不同方式的組合。關係?要找出四種操作彼此之間的聯繫。無論其具體的表現形式是如何的,但是彼此之間的聯繫,具有一定的規則,這是不會改變的。這個規則在程式設計的時候就已經明確了。理性的認識就是要從實踐活動中抽象掉千變萬化的現象,找到靜止不變的彼此之間的聯繫。也即是本質。本質是靜止的不變的嗎?在一定的條件下,這個條件是在這裡是指軟體的版本。軟體的版本不變,這個軟體中的四項內容,彼此之間的關係就不會改變。從這個意義上,本質是不變的,也即事物是處在量變的過程。 作者在私有文件夾中究竟是保存文章還是保存圖片,對於文件夾的共用方式,用戶許可權沒有任何的影響。保存文章或者保存圖片又或者保存視頻,用戶、文件夾、許可權、共用,這四項彼此關係並不發生改變。這就是本質,變化的只是保存文件的類型。也即是現象。從這個意義上來說本質是靜止的,現象是變化的。 軟體的版本變化了,用戶、文件夾、許可權、共用四項內容的關係也就可能發生改變,也可能不變。這個要通過實踐來檢驗。從這個意義外說本質又是變化的。 文件伺服器基本的四項內容:用戶、文件夾、許可權、共用。無論軟體的版本怎麼的變化,這四項內容是基本不變的,也即是點。變化了的是彼此之間的關係,但是內容是不變的。從這個意義上來說,內容比關係又更加的抽象,也即內容是本質,是不變的。彼此的關係反而是現象,是變化的。
理論脫離實踐活動,也就沒有任何的意義。從這點來說,理論性的文章必然有具體行業的,具體社會活動做為基礎。從某一個行業形成的,某一個社會活動中的理論是不是會片面呢? 一方面理論是片面的,理論總有這個理論適用的範圍。一方面理論是全面的,因為事物有共性。任何事物最初都是從無到有,生命的細胞是如此,天下萬物也是如此。這就是中國古代哲學家發現的,天下萬物生於有,有生於無。天下萬物有其共性,那麼由萬物由生產出來的理論,必然也就有共性。人的認識具有普遍性的意義,這不奇怪。 理論性的文章,沒有具體的實踐活動,科學實驗,沒有了社會活動做基礎。那就成了無源之水,無根之木。最後只能是不斷的搬來倒去的堆徹一些哲學上的詞語。在哲學里哲學,在理論里理論。哲學家們只是不斷的解釋世界,問題在於改造人們的現實生活。 這是一篇準備建立FreeNAS伺服器時所想到的文章,要寫一本用戶手冊,寫一個說明書。結果寫成了這樣的內容。想到那就寫到那裡吧,想到什麼就寫些什麼。文章看起來沒有條理,天馬行空,很是混亂。就是我自己也有這樣的感覺。