網站首頁 編程語言 正文
軟件文檔的質量甚至關乎項目的最終成敗和可維護性。文檔編寫需要遵守以下規范:
1、針對性。文檔編制前應分清讀者對象。對不同的類型、不同層次的讀者,決定如何滿足適應他們的需要。
2、精確性。文檔的行文應當十分確切,不能出現多義性的描述。
3、清晰性。文檔編寫應力求簡明,如有可能,配以適當的圖表,以增強其清晰性。
4、完整性。任何一個文檔都應當是完整的、獨立的,它應自成體系。例如,前言部分應做一般性介紹,正文給出中心內容,必要時還有附錄,列出參考資料等。
5、靈活性。各個不同軟件項目,其規模和復雜程度有著許多實際差別,不能相同看待。
原文鏈接:https://blog.csdn.net/xal0610/article/details/113887082
相關推薦
- 2022-11-17 Python操作MongoDB的教程詳解(插,查,改,排,刪)_python
- 2022-07-25 通過底層源碼理解YOLOv5的Backbone_python
- 2023-10-13 Error: cannot push because a reference that you ar
- 2022-09-25 判斷單鏈表保存的字符串是否是回文字符串
- 2022-10-31 一篇文章教會你使用gs_restore導入數據_數據庫其它
- 2023-07-03 什么是懶加載,如何實現圖片或列表懶加載?
- 2022-05-26 解決redis批量刪除key值的問題_Redis
- 2022-09-20 Redis超詳細分析分布式鎖_Redis
- 最近更新
-
- window11 系統安裝 yarn
- 超詳細win安裝深度學習環境2025年最新版(
- Linux 中運行的top命令 怎么退出?
- MySQL 中decimal 的用法? 存儲小
- get 、set 、toString 方法的使
- @Resource和 @Autowired注解
- Java基礎操作-- 運算符,流程控制 Flo
- 1. Int 和Integer 的區別,Jav
- spring @retryable不生效的一種
- Spring Security之認證信息的處理
- Spring Security之認證過濾器
- Spring Security概述快速入門
- Spring Security之配置體系
- 【SpringBoot】SpringCache
- Spring Security之基于方法配置權
- redisson分布式鎖中waittime的設
- maven:解決release錯誤:Artif
- restTemplate使用總結
- Spring Security之安全異常處理
- MybatisPlus優雅實現加密?
- Spring ioc容器與Bean的生命周期。
- 【探索SpringCloud】服務發現-Nac
- Spring Security之基于HttpR
- Redis 底層數據結構-簡單動態字符串(SD
- arthas操作spring被代理目標對象命令
- Spring中的單例模式應用詳解
- 聊聊消息隊列,發送消息的4種方式
- bootspring第三方資源配置管理
- GIT同步修改后的遠程分支