讀我檔案
外觀
此條目需要補充更多來源。 (2012年8月15日) |
讀我檔案(英語:Readme,中國大陸作自述文件),是隨著軟體發佈的一種說明文件,裡面通常包含有軟體的描述或使用的注意事項。這種檔案通常是純文字檔案,被命名為README
、Read Me
、READ.ME
、README.txt
等等,但也有RTF、DOC或Markdown格式的讀我檔案。檔名通常是以大寫英文字母組成,這是因為大寫字母比小寫字母有著較小的ASCII碼,因此在一些以ASCII順序來排序檔案名稱的作業系統裡,它會被列在檔案列表的第一個。即使這些人沒有關於讀我檔案的知識,這種檔案的特殊命名方式也能夠使任何人迅速發現。
內容
[編輯]讀我檔案的內容通常包含:
- 設定指南
- 安裝指南
- 操作指南
- 檔案列表(隨著軟體而發佈的檔案)
- 著作權聲明
- 軟體作者的聯絡方法
- 已知程式錯誤
- 疑難排解
- 致謝
- 更新記錄
通用介面說明
[編輯]讀我檔案偶爾也會被用來形容一些提供資訊的檔案,包含讀我檔案普遍的內容。在一些開放原始碼的程式,特別是以GNU建置系統打包的檔案裡,通常會包含:
- README:一般資訊
- AUTHORS:作者
- THANKS:致謝
- ChangeLog:更新記錄,通常為程式管理員而設
- NEWS:更新記錄,但專為使用者而設
- INSTALL:安裝指南
- COPYING:著作權聲明
- BUGS:已知程式錯誤,亦包括回報錯誤的方法[1]
- FAQ:有關軟體的問答[1]
- TODO:更新預告
額外閱讀
[編輯]- Johnson, Mark. Building a Better ReadMe. Technical Communication (Society for Technical Communication). February 1997, 44 (1): p28–36. (原始內容存檔於2013-11-04).
- Livingston, Brian. Check your Readme files to avoid common Windows problems. InfoWorld. 14 September 1998, 20 (37): p34.