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(可以, 可選)
    • 完全可選的需求
      • 不強制實作
    • 沒有實作此需求的產品必須能夠和有實作此需求的產品互動(Interoperate),反之亦然

使用方式

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

安全考量

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

參考資料

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