如何记录 HTTP 标头

步骤 1——确定要记录的 HTTP 标头

• 各种 IETF 标准中定义了许多 HTTP 标头。
• IANA 维护着一个标头注册表，而维基百科则列出了已知的标头字段，但并非所有标头都与 Web 开发人员相关，或者属于官方标准。
• 如果当前的 HTTP 标头参考概述页面上有任何红色链接，那么这些标头是很好的可以记录的选择。
• 如果有任何疑问，请向 MDN Web 文档团队询问是否有必要记录你选择的标头。

步骤 2——检查现有的 HTTP 标头页面

• 现有的 HTTP 标头在这里记录。
• 有不同的标头类别：请求标头、响应标头和表示标头。
• 找到你要记录的标头的类别（请注意，某些标头既可以是请求标头，也可以是响应标头，这取决于上下文）。
• 转到现有的具有相同类别的标头参考页。

步骤 3——创建 HTTP 标头页面

• 所有标头页面都位于此目录下：/docs/Web/HTTP/Headers/
• 要创建新页面，请参阅我们的如何创建页面指南中的说明。

步骤 4——撰写内容

• 从我们的 HTTP 标头模板页面开始，或者使用你从步骤 2 中找到的现有 HTTP 标头文档中的一个复制的结构。由你自己决定。
• 撰写关于新 HTTP 标头的内容。
• 确保你有以下这些部分：
  • 介绍性文本，其中第一句提到标头名称（加粗）并总结其目的。
  • 信息框，其中至少包含标头类型以及标头是否为禁止修改的标头。
  • 语法框，其中包含 HTTP 标头的所有可能的指令/参数/值。
  • 一个解释这些指令/值的部分。
  • 一个示例部分，其中包含此标头的实际用例，或者显示它通常出现的位置和方式。
  • 一个规范部分，列出相关的 RFC 标准文档。
  • 一个“参见”部分，列出相关资源。

步骤 5——添加浏览器兼容性信息

• 如果你查看过其他 HTTP 标头页面，你会发现有一个 {{Compat}} 宏，它会为你填充一个浏览器兼容性表。
• 兼容性表格页面是通过结构化数据生成的。如果你想为数据做出贡献，请查看 https://github.com/mdn/browser-compat-data/blob/main/README.md 中的说明，并向我们发送拉取请求。

步骤 6——更新 HTTP 标头列表

请确保你的标头在 HTTP 标头参考概述页面上的适当类别中列出。

步骤 7——内容审查

在创建标头页面后，请将其以拉取请求的形式提交。会自动分配我们审查团队的成员来审查你的页面。