RFC2119簡介

簡介

• RFC (Request For Comments，請求意見稿)
  • 記錄網際網路規範、協定、過程等的標準檔案
• RFC2119用五個關鍵詞來定義需求的嚴格程度

名詞解釋

這些詞通常會以大寫字母的形式出現(中文可以用斜體或粗體強調)

1. MUST, REQUIRED, SHALL(強制, 必須, 務必, 只能)
   • 絕對必要的需求
2. MUST NOT, SHALL NOT(禁止, 不能, 不要)
   • 絕對禁止的需求
   • MUST的反意詞
3. SHOULD, RECOMMENDED(應, 應該, 建議, 推薦)
   • 可能有特定原因或環境，需要忽略某些需求
   • 在了解後果的前提下，可以選擇這樣做
   • 在用不建議的選擇之前，需仔細考慮
4. SHOULD NOT, NOT RECOMMENDED(不應, 不應該, 不建議, 不推薦)
   • SHOULD的反義詞
5. MAY, OPTIONAL(可以, 可選)
   • 完全可選的需求
     • 不強制實作
   • 沒有實作此需求的產品必須(MUST)能夠和有實作此需求的產品互動(Interoperate)，反之亦然

使用方式

• 這些祈使詞必須被小心地、保守地使用
• 這些祈使詞的使用必須是出於互動的實際需要、或是為了限制可能的潛在危害

安全考量

• 這些詞語常用於安全性暗示(Security Implication)
  • 安全的影響可能不明顯
    • 文件作者需要闡述(elaborate)不遵守這些要求會帶來的問題

參考資料

• RFC2119原文
• 中文技術文檔寫作風格指南
• 翻譯 RFC 2119: 在 RFC 文檔中, 用於指出規范的要求級別的關鍵詞