用戶手冊編制規(guī)范

  文件類別:說明標準

  文件格式:文件格式

  文件大小:122K

  下載次數(shù):1084

  所需積分:8點

  解壓密碼:qg68.cn

  下載地址:[下載地址]

清華大學卓越生產(chǎn)運營總監(jiān)高級研修班

綜合能力考核表詳細內(nèi)容

用戶手冊編制規(guī)范
用戶手冊對于任何產(chǎn)品都是不可缺少的組成部分。一個好的產(chǎn)品沒有一份完備的用戶手冊,也不能算作一個完備的產(chǎn)品。對于軟件產(chǎn)品來說更是如此,沒有用戶手冊的軟件不能算產(chǎn)品,沒有好的用戶手冊,就不可能算好產(chǎn)品。也就是說,一個好的軟件產(chǎn)品除了具備與市場對路的思想、良好的用戶界面、完備的測試之外,還必須有一本適合用戶使用的用戶手冊。
本規(guī)范手冊不僅指明了軟件用戶手冊的內(nèi)容,而且規(guī)定了沈陽東大阿爾派軟件股份有限公司軟件用戶手冊的統(tǒng)一版面、格式。本規(guī)范手冊就是按本規(guī)定編寫的,但由于本規(guī)范手冊內(nèi)容的局限性,很難以樣本的形式表現(xiàn)軟件用戶手冊中可能出現(xiàn)的各種情況,所以請大家認真閱讀本規(guī)范手冊的內(nèi)容。
我們希望沈陽東大阿爾派軟件股份有限公司的相關(guān)人員,能夠按照本規(guī)范手冊編寫自己的軟件用戶手冊,做好我們的軟件產(chǎn)品化工作。由于時間倉促,編者水平有限,希望大家能夠提出寶貴意見,以逐步完善本規(guī)范手冊的內(nèi)容。

閱讀指南
〖手冊目標〗
本手冊主要對沈陽東大阿爾派軟件股份有限公司軟件產(chǎn)品的用戶手冊所應包含的內(nèi)容及版面格式作一個初步的統(tǒng)一規(guī)定。由于實際情況千變?nèi)f化,本規(guī)定很難一次做到面面俱到,需要逐漸完善。
〖閱讀對象〗
本手冊是為沈陽東大阿爾派軟件股份有限公司的所有軟件開發(fā)人員和軟件用戶手冊編寫人員所編寫的。由于本手冊中的格式規(guī)定部分是根據(jù) Microsoft Windows 下的 Word 的功能而編寫的,所以沈陽東大阿爾派軟件股份有限公司的軟件用戶手冊應該使用 MicroSoft Word排版。
〖手冊構(gòu)成〗
本手冊基本上由兩部分組成:
1. 第1章,“關(guān)于用戶手冊排版格式的規(guī)定”,規(guī)定了用戶手冊標題及編號的格式。
2. 第2章,“用戶手冊的內(nèi)容”,規(guī)定了用戶手冊所應包含內(nèi)容較為詳細的清單。
另外,本手冊基本上是按“用戶手冊格式的統(tǒng)一規(guī)定”編寫的一個樣本。
〖手冊約定〗
本手冊遵循以下約定:
1. 所有標題均使用黑體字。
2. 如果標題后跟有“〖條件〗”字樣,說明該標題下正文所要求的內(nèi)容是在一定條件下必須的。
【注意】的意思是請讀者注意那些需要注意的事項。
【警告】的意思是請讀者千萬注意某些事項,否則將造成嚴重錯誤。


目 錄


第1章 用戶手冊格式規(guī)定 1-1
§1.1 標題及編號 1-1
§1.1.1 章標題的設置 1-1
§1.1.2 節(jié)標題的設置 1-1
§1.1.3 小節(jié)標題的設置 1-1
§1.1.4項目符號和編號的設置 1-2
§1.1.5 其它編號的設置 1-3

§1.2 正文及頁眉頁腳的排版 1-4
§1.2.1 正文排版 1-5
§1.2.2 版面設置 1-5
§1.2.2.1 版面設置 1-5
§1.2.2.2 關(guān)于頁眉、頁腳的設置 1-5
§1.2.2.3 注意與警告 1-5

第2章 用戶手冊的內(nèi)容 2-1
§2.1 用戶手冊的目標 2-4
§2.2 用戶手冊的內(nèi)容 2-4
§2.2.1 封面 2-4
§2.2.2 二封 2-4
§2.2.3 版權(quán)聲明 2-4
§2.2.4 前言 2-4
§2.2.5 閱讀指南 2-5
§2.2.6目錄 2-5
§2.2.7基礎知識介紹〖條件〗 2-5
§2.2.8 系統(tǒng)安裝及啟動 2-6
§2.2.9 系統(tǒng)操作說明 2-7
§2.2.9 1 CAD軟件 2-7
§2.2.9 2 其它軟件 2-9
§2.2.10 系統(tǒng)及數(shù)據(jù)維護 2-9
§2.2.11 例題〖條件〗 2-10
§2.2.12 各種附錄 2-10
§2.3 用戶手冊的風格 2-11

第1章 用戶手冊格式的規(guī)定
§1.1 標題及編號
一般情況下,用戶手冊用章、節(jié)來劃分其內(nèi)容,必要時還可引入小節(jié)、小小節(jié)的概念。
§1.1.1 章標題的設置
每章的編號用阿拉伯數(shù)字表示,采用“第1章”、“第2章”、……的形式表示章的編號,章的編號后面空一個半角的格,然后是這一章的標題。
1. 章必須另起一頁開始打印。
2. 章的編號和標題采用左對齊的格式放在行的左邊,左縮進為0。
3. 章的編號和標題中漢字采用黑體小三號字,章的編號和標題總長度不能超過一行。
4. 章的編號和標題行距取最小值、12磅,段前、段后分別取24磅。
§1.1.2 節(jié)標題的設置
節(jié)的編號格式為“§x.y”。其中,x為章的號碼,y為節(jié)的號碼,用阿拉伯數(shù)字表示。節(jié)的編號后面空一個半角的格,然后是這一節(jié)的標題。
1. 原則上每一節(jié)另起一頁開始打印,但對于每章的第一節(jié),如果章標題下無說明文字,可以將其與章標題放于一頁之中。
2. 節(jié)的編號和標題采用左對齊的格式放在行的左邊,左縮進為0。
3. 節(jié)的編號和標題中漢字采用黑體四號字,節(jié)的編號和標題總長度不能超過一行。
4. 節(jié)的編號和標題行距取最小值、12磅,對于與章標題處于同頁的要將其段前、段后均取12磅,否則段前取24磅、段后取12磅。
§1.1.3 小節(jié)標題的設置
小節(jié)的編號格式為“§x.y.z”。其中x為章的號碼,y為節(jié)的號碼,z為小節(jié)號碼,用阿拉伯數(shù)字表示。小節(jié)的編號后面空一個半角的格,然后是這一小節(jié)的標題。
1. 小節(jié)不必另起一頁開始打印。
2. 小節(jié)的編號和標題采用左對齊的格式放在行的左邊,左縮進0.74CM。
3. 小節(jié)的編號和標題中漢字采用黑體小四號字,小節(jié)的編號和標題總長度不能超過一行。
4. 小節(jié)的編號和標題行距取最小值、12磅,段前取12磅。
【注意】
1. 如果有必要,還可以在小節(jié)下面劃分更小的節(jié),我們暫且稱之為小小節(jié)。
2. 對于小小節(jié)的各種規(guī)定與小節(jié)一致,為保持版面清晰,小小節(jié)不再相對于小節(jié)向右縮進。
3. 在用戶手冊中,系統(tǒng)提示信息采用幼圓五號字,其余所有的數(shù)字及字母采用Arial字體,字號與相應的漢字相同。在本規(guī)范中提到的字體如無特殊注明,均指漢字字體。
4. 用戶手冊中,行距均取最小值、12磅。
§1.1.4 項目符號和編號的設置
在章、節(jié)、小節(jié)、小小節(jié)里面均可以含有項目符號和編號。
1. 編號
1) 編號序列相對于與之對應的標題向右縮進0.74CM。
2) 編號的格式是“n.”,其中n為阿拉伯數(shù)字。
3) 對于有名編號序列名稱采用五號黑體漢字,其后面的內(nèi)容采用五號宋體漢字;對于無名編號序列中的內(nèi)容字體同有名編號序列。
4) 編號序列里還允許采用二級編號序列,其格式規(guī)定如下:“n)”,其中n為阿拉伯數(shù)字。
5) 二級編號相對于與之對應的一級編號向右縮進0.74CM。
6) 其它規(guī)定和一級編號序列一致。
7) 編號及二級編號的行間距取最小值,12磅。一級編號的第一項段前取12磅,其余各項及二級編號段前均取6磅。
2. 項目符號
1) 項目符號相對于與之對應的標題或編號序列向右縮進0.74CM。
2) 項目符號的格式是“”,其中“”字體為Wingdings,五號字。
3) 對于有名項目符號序列,名稱采用五號黑體漢字,其后面的正文采用宋體五號字,對于無名項目符號序列中的內(nèi)容字體同有名編號序列。
4) 如果項目符號序列處于編號序列的下級,則各項各項段前均取6磅;否則首項段前取12磅,其余各項段前取6磅。
【注意】項目符號和編號下的敘述文字相對于與之對應的項目符號或編號向右縮進0.74CM,首行縮進0.74CM,段前取6磅。漢字字體取宋體五號。
§1.1.5 其它編號的設置
1. 頁編號:用戶手冊中的正文按章進行編號,其格式為“章-頁”。如,第2章的第3頁,編號為“2-3”。頁編號放在頁腳中,具體設置方法詳見“頁眉、頁腳設置”。
2. 圖、表編號:
用戶手冊中的圖、表均按章分別進行編號,其格式分別為“圖x-y”、“表x-y”。如,第2章的第3幅圖的編號是“圖2-3”;第2章的第3張表格的編號是“表2-3”。在圖表編號的后面空一個半角的格,然后是這一圖表的名稱。另外,還規(guī)定:
1) 表的編號與名稱放在表的頂部。
2) 表的編號與名稱和表左對齊,而整個表則居中放置。
3) 表的編號與名稱段后取6磅。
4) 圖的編號與名稱放在圖的底部。
5) 圖的編號與名稱和圖均居中放置。
6) 圖的編號與名稱段前取6磅。
7) 圖前面的正文段后取12磅。
8) 圖、表的編號與名稱中漢字采用黑體五號字。

§1.2 正文及頁眉、頁腳的排版
§1.2.1 正文排版
正文排版包括字符排版、段落排版、圖形排版和版權(quán)聲明、目錄等的排版,本節(jié)就這幾方面的格式要求加以詳細闡述。
1. 字符排版:
1) 用戶手冊的正文,系統(tǒng)提示采用幼圓五號字體,其余采用宋體五號字。
2) 對于界面中的按鈕名稱,應把按鈕名稱用“〈〉”括起來,按鈕名稱用黑體五號字書寫。對于下拉菜單選項的名稱,應用“”引起來,選項名稱用宋體五號字書寫。對于熱點,應用“”引起來,熱點名稱用黑體五號字書寫。
3) 正文均采用常規(guī)字體、標準位置、標準間距。
2. 段落排版:
1) 正文段落的首行相對于與之對應的標題或編號序列向右縮進0.74CM。
2) 行距采用最小值,12磅,除項目符號及編號以及圖形前面正文按前面所述的特殊要求進行排版外,其余段前均取12磅。
3) 采取兩端對齊方式。
3. 圖形的排版:
1) 屏幕截圖時,應使所截圖片的尺寸為最大。
2) 對于尺寸較大的圖片,可使圖片的高度和寬度按同比例適當縮小。
3) 必要時可適當縮小或?qū)D片移到下一頁,以保證圖片與圖號及圖名在同頁。
4) 當正文中對圖標進行說明時,應使圖標同與之對應的標題對齊。
5) 為保證頁面清晰,可適當調(diào)整圖標右側(cè)說明文字的行間距以及段前、段后。
6) 在屏幕截圖時,圖片中輸入的數(shù)據(jù)不能包含本公司員工的真實姓名。
4. 版權(quán)聲明、目錄等的排版:
版權(quán)聲明、前言、閱讀指南、目錄的標題為段前取36磅,段后取24磅,采用黑體小三號字;內(nèi)容排版與手冊正文排版相同。

§1.2.2 版面設置
§1.2.2.1 版面設置
對于版面設置作如下規(guī)定:
1. 紙張大?。河脩羰謨杂眉埥y(tǒng)一規(guī)定為16開。
2. 頁邊距:上:30mm;下:20mm;內(nèi)側(cè):21mm;外側(cè):16mm。另外采用“對稱頁邊距”;對于版面設置頁眉、頁腳應選用“首頁不同”和“奇偶頁不同”。
3. 對于新項目或新產(chǎn)品可根據(jù)具體情況對版面設置適當做一些修改。
§1.2.2.2 關(guān)于頁眉、頁腳的設置
1. 頁眉的設置:
1) 版權(quán)聲明、前言、閱讀指南、目錄均無篇眉。
2) 章編號和名稱所在頁的篇眉為一行有50%填充的邊框。
3) 對于單號頁,頁眉的內(nèi)容是當前章的標題名,要求打印在紙的右上角。
4) 對于雙號頁,頁眉的內(nèi)容是用戶手冊的名稱,要求打印在紙的左上角。
5) 紙的頂邊與頁眉的距離是23mm。
6) 頁眉中漢字采用幼圓小五號字。
2. 頁腳的設置:
1) 頁腳的內(nèi)容是當前頁的頁編號,如第2章第2頁為2-2。
2) 頁編號的字體采用Arial五號字。
3) 紙的底邊與頁腳的距離是13mm。
4) 版權(quán)聲明、前言、閱讀指南、目錄的頁腳為ⅰ,ⅱ等,居中放置,不帶邊框。
§1.2.2.3 注意與警告
在用戶手冊中,對于那些需要用戶特別注意的事項,應該用“【注意】”作為標志給用戶以特別的提示。關(guān)于注意標志和注意事項的格式有如下規(guī)定:
1. 注意標志同與之對應的標題對齊。
2. 注意標志采用黑體小四號漢字。
3. 注意標志段前取12磅。
4. 如果注意事項只有一條,其內(nèi)容應該緊跟在注意標志的后面書寫;否則,應該在注意標志的下一行開始,采用編號序列的形式分別給出。
在用戶手冊中,對于那些會給用戶造成重大損失的行為,應該用“【警告】”作為標志給用戶以警告性的提示。
【注意】關(guān)于警告標志和警告事項的格式規(guī)定與關(guān)于注意標志和注意事項的格式規(guī)定一致。


第2章 用戶手冊的內(nèi)容
本章主要討論編寫用戶手冊所要達到的目標、軟件用戶手冊所應包含的內(nèi)容、以及在用戶手冊編寫過程中所應保持的風格。
如果標有“〖條件〗”字樣,說明該部分內(nèi)容是在一定條件下所必須的。

§2.1 用戶手冊的目標
某軟件評測中心把軟件產(chǎn)品評測測試分為兩個階段——初評安裝測試和復評測試。只有通過初評安裝測試的軟件才能進入復評測試,初評安裝測試的內(nèi)容包括:
1. 按照軟件用戶手冊中的安裝說明測試軟件能否順利安裝成功。
2. 對照軟件用戶手冊測試軟件功能是否與手冊描述一致。
3. 評價產(chǎn)品包裝及用戶手冊是否符合商品化要求。
4. 通過以上三方面測試且無嚴重死機情況的軟件可進入復評測試。
由此,我們可以看到軟件用戶手冊是一個軟件產(chǎn)品的基礎,沒有合格的軟件用戶手冊就根本談不上合格的軟件產(chǎn)品。另一方面,良好的安裝說明及軟件功能與手冊描述的一致性是對軟件用戶手冊的兩個基本要求。
我們編寫的用戶手冊要達到兩個目的:
1. 讓用戶手冊成為用戶學習使用我們產(chǎn)品的最好教材。用戶通過閱讀用戶手冊,應該對我們產(chǎn)品的功能、操作有一定的認識;按照用戶手冊上的說明,通過實際操作,用戶應該能夠掌握我們產(chǎn)品的操作過程。
2. 讓用戶手冊能夠起到降低銷售費用的作用。用戶手冊不僅應該包括我們的產(chǎn)品操作說明,而且還應該包括系統(tǒng)(軟件和必要的硬件)安裝、數(shù)據(jù)維護、出錯處理等。通過用戶手冊,就可以讓用戶掌握在使用我們軟件的過程中出現(xiàn)各種情況的處理方法。
為達到這兩個目標,在一般情況下,用戶手冊應該包含如下幾個方面的內(nèi)容:
用戶手冊編制規(guī)范
 

[下載聲明]
1.本站的所有資料均為資料作者提供和網(wǎng)友推薦收集整理而來,僅供學習和研究交流使用。如有侵犯到您版權(quán)的,請來電指出,本站將立即改正。電話:010-82593357。
2、訪問管理資源網(wǎng)的用戶必須明白,本站對提供下載的學習資料等不擁有任何權(quán)利,版權(quán)歸該下載資源的合法擁有者所有。
3、本站保證站內(nèi)提供的所有可下載資源都是按“原樣”提供,本站未做過任何改動;但本網(wǎng)站不保證本站提供的下載資源的準確性、安全性和完整性;同時本網(wǎng)站也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的損失或傷害。
4、未經(jīng)本網(wǎng)站的明確許可,任何人不得大量鏈接本站下載資源;不得復制或仿造本網(wǎng)站。本網(wǎng)站對其自行開發(fā)的或和他人共同開發(fā)的所有內(nèi)容、技術(shù)手段和服務擁有全部知識產(chǎn)權(quán),任何人不得侵害或破壞,也不得擅自使用。

 我要上傳資料,請點我!
人才招聘 免責聲明 常見問題 廣告服務 聯(lián)系方式 隱私保護 積分規(guī)則 關(guān)于我們 登陸幫助 友情鏈接
COPYRIGT @ 2001-2018 HTTP://musicmediasoft.com INC. ALL RIGHTS RESERVED. 管理資源網(wǎng) 版權(quán)所有