使用者手冊(gb8567——88)
說明編寫這份使用者手冊的目的,指出預期的讀者。
說明:
a. 這份使用者手冊所描述的軟體系統的名稱; b.
該軟體專案的任務提出者、開發者、使用者(或首批使用者)及安裝此軟體的計算中心。
列出本檔案中用到的專門術語的定義和外文首字母組詞的原片語。 a.
專案的經核准的計畫任務書或合同、上級機關的批文; b.
屬於本專案的其他已發表檔案; c.
本檔案中各處引用的檔案、資料,包括所要用到的軟體開發標準。列出這些檔案資料的標題、檔案編號、發表日期和出版單位,說明能夠取得這些檔案資料的**。
結合本軟體的開發目的逐項地說明本軟體所具有各項功能以及它們的極限範圍。
逐項說明對各項輸入資料的精度要求和本軟體輸出資料達到的精度,包括傳輸中的精度要求。
定量地說明本軟體的時間特性,如響應時間,更新處理時間,資料傳輸、轉換時間,計算時間等。
說明本軟體所具有的靈活性,即當使用者需求(如對操作方式、執行環境、結果精度、時間特性等的要求)有某些變化時,本軟體的適應能力。
說明本軟體在安全、保密方面的設計考慮和實際達到的能力。
列出為執行本軟體所要求的硬裝置的最小配置,如: a.
處理機的型號、記憶體容量; b.
所要求的外儲存器、**、記錄格式、裝置的型號和台數、聯機/離線; c.
i/o裝置(聯機/離線?); d.
資料傳輸裝置和轉換裝置的型號、台數。
說明為執行本軟體所需要的支援軟體,如: a.
作業系統的名稱、版本號; b.
程式語言的編譯/彙編系統的名稱和版本號; c.
資料庫管理系統的名稱和版本號; d.
其他支援軟體。
列出為支援本軟體的執行所需要的資料庫或資料文捲。
在本章,首先用圖表的形式說明軟體的功能同系統的輸入源機構、輸出接收機構之間的關係。
一步一步地說明為使用本軟體而需進行的安裝與初始化過程,包括程式的儲存形式、安裝與初始化過程中的全部操作命令、系統對這些命令的反應與答覆。表徵安裝工作完成的測試例項等。如果有的話,還應說明安裝過程中所需用到的專用軟體。
規定輸入資料和參量的準備要求。
說明輸入資料的現實背景,主要是 a.
情況——例如人員變動、庫存缺貨; b.
情況出現的頻度——例如是週期性的、隨機的、一項操作狀態的函式; c.
情況**—一例如人事部門、倉庫管理部門; d.
輸入**———例如鍵盤、穿孔卡片、磁帶; e.
限制——出於安全、保密考慮而對訪問這些輸入資料所加的限制; f.
質量管理——例如對輸入資料合理性的檢驗以及當輸入資料有錯誤時應採取的措施,如建立出錯情況的記錄等; g.
支配——例如如何確定輸入資料是保留還是廢棄,是否要分配給其他的接受者等。
說明對初始輸入資料和參量的格式要求,包括語法規則和有關約定,如: a.
長度—一例如字元數/行,字元數/項; b.
格式基準——例如以左面的邊沿為基準; c.
標號——例如標記或識別符號; d.
順序——例如各個資料項的次序及位置; e.
標點——例如用來表示行、資料組等的開始或結束而使用的空格、斜線、星號、字元組等。 f.
詞彙表——給出允許使用的字元組合的列表,禁止使用*的字元組合的列表等; g.
省略和重複——給出用來表示輸人元素可省略或重複的表示方式; h.
控制——給出用來表示輸入開始或結束的控制資訊。
為每個完整的輸入形式提供樣本,包括: a.
控制或首部——例如用來表示輸入的種類和型別的資訊,識別符號輸入日期,正文起點和對所用編碼的規定; b.
主體——輸入資料的主體,包括資料文捲的輸入表述部分; c.
尾部——用來表示輸入結束的控制資訊,累計字元總數等; d.
省略——指出哪些輸入資料是可省略的; e.
重複——指出哪些輸入資料是重複的。
說明輸出資料的現實背景,主要是: a.
使用——這些輸出資料是給誰的,用來幹什麼; b.
使用頻度——例如每週的、定期的或備查閱的; c.
**——列印、
cri顯示、磁帶、卡片、磁碟, d.
質量管理—一例如關於合理性檢驗、出錯糾正的規定; e.
支配——例如如何確定輸出資料是保留還是廢棄,是否要分配給其他接受者等。
給出對每一類輸出資訊的解釋,主要是: a.
首部——如輸出資料的識別符號,輸出日期和輸出編號; b.
主體——輸出資訊的主體,包括分欄標題; c.
尾部——包括累計總數,結束標記。
為每種輸出型別提供例子。對例子中的每一項,說明: a.
定義——每項輸出資訊的意義和用途; b.
**——是從特定的輸入中抽出、從資料庫文捲中取出、或從軟體的計算過程中得到; c.
特性——輸出的值域、計量單位、在什麼情況下可預設等。
這一條的編寫針對具有查詢能力的軟體,內容包括:同資料庫查詢有關的初始化、準備、及處理所需
要的詳細規定,說明查詢的能力、方式,所使用的命令和所要求的控制規定。
列出由軟體產生的出錯編碼或條件以及應由使用者承擔的修改糾正工作。指出為了確保再啟動和恢復的能力,使用者必須遵循的處理過程。
當軟體是在多終端系統上工作時,應編寫本條,以說明終端的配置安排、連線步釋、資料和引數輸入步驟以及控制規定.說明通過終端操作進行查詢、檢索、修改資料文捲的能力、語言、過程以及輔助性程式等。
使用者手冊(GB8567 88)
1引言 2 1.1編寫目的 2 1.2背景 2 1.3定義 2 1.4參考資料 2 2用途 2 2.1功能 2 2.2效能 3 2.2.1精度 3 2.2.2時間特性 3 2.2.3靈活性 3 2.3安全保密 3 3執行環境 3 3.1硬裝置 3 3.2支援軟體 3 3.3資料結構 4 4使用過程 ...
操作手冊(GB8567 88)
操作手冊 gb8567 88 說明編寫這份操作手冊的目的,指出預期的讀者。說明 a 這份操作手冊所描述的軟體系統的名稱 b 該軟體專案的任務提出者 開發者 使用者 或首批使用者 及安裝該軟體的計算中心。列出本檔案中用到的專門術語的定義和外文首字母組詞的原片語。a 本專案的經核准的計畫任務書或合同 上...
操作手冊(GB8567 88)
1引言 2 1.1編寫目的 2 1.2前景 2 1.3定義 2 1.4參考資料 2 2軟體徵述 2 2.1軟體的結構 2 2.2程式表 2 2.3文捲表 3 3安裝與初始化 3 4執行說明 3 4.1執行表 3 4.2執行步驟 3 4.3執行1 識別符號 說明 3 4.3.1執行控制 3 4.3.2...