提出新内容或功能
我们一直乐于听取社区关于对 MDN Web 文档的新内容或功能建议。但是,即使我们对建议持开放态度,我们也必须牢记以下几点
- MDN Web 文档由一个小型的内部团队运行和管理。我们也高度依赖我们的合作伙伴和社区来帮助我们让 MDN Web 文档成为网络上最适合 Web 开发人员的资源。因此,我们有时不得不拒绝新内容或功能,因为我们根本无法长期维护它们。
- MDN Web 文档还专注于记录开放 Web 标准;某些内容可能不适合。这并不意味着想法或内容不好,只是 MDN Web 文档不是最适合它的地方。
牢记这一点,如果您确实想为 MDN Web 文档提出内容或功能,请按照以下步骤操作。
打开内容建议和功能提案问题
当您打开一个新问题时,您会发现一个名为“新内容或功能建议”的模板。这是在建议新内容或功能时使用的问题模板。问题模板确实需要相当多的信息,但这是有意的。
- 它确保我们拥有审查您的提案所需的所有信息,无需反复沟通。
- 它可以帮助您在填写表格时思考您的提案。
填写完表格并提交问题后,核心团队成员将在 1 到 2 周内回复您,具体取决于您提案的复杂程度。
参与讨论并等待批准
如果我们认为提案可能适合,我们将在我们的 MDN 社区讨论存储库中启动讨论。这是为了征求我们合作伙伴和更广泛社区的意见。我们鼓励您监控讨论并适时加入。
打开问题
假设达成共识,我们希望添加此内容或构建此功能。在这种情况下,我们将针对适当的存储库打开一个问题,引用原始提案和讨论,并填补任何空白,以便问题可以明确执行。
工作分配
此时,工作将被优先处理并分配给负责确保其实施和审查的人员。
打开拉取请求
当工作准备好审查时,应打开一个拉取请求,该请求再次引用提案、讨论和问题。这确保我们始终拥有工作的完整背景。最后,将分配必要的人员,并开始审查过程。
工作被审查和合并
同样,根据内容或功能的复杂程度,审查阶段可能会很长。我们恳请您耐心等待,并在适当的时候继续参与。一旦我们获得至少两名内部团队成员的批准,我们就可以合并拉取请求。
这将结束整个流程,内容或功能将可在 MDN Web 文档中使用。