XEP-0143
来自Jabber/XMPP中文翻译计划
(版本间的差异)
(→简介) |
(→提交提案之前) |
||
第40行: | 第40行: | ||
==提交提案之前== | ==提交提案之前== | ||
+ | |||
+ | 强烈鼓励一个可能的作者在提交一个提案成为一个XEP之前完成一些研究. 特别是, 该作者应该做以下几件事: | ||
+ | |||
+ | :* 查看XMPP RFCs和实验性的, 活跃的, 草案, 和最终XEPs以决定是否真的为了填补现有的XMPP技术和协议的空白而需要该建议的协议扩展. | ||
+ | :* 查看被拒绝的和被延期的XEPs, 以及那些永远不会被接受的提案(见 <http://xmpp.org/extensions/inbox/>)来决定是否过去已经有类似的扩展提案但是没有被[http://xmpp.org/council/ XMPP理事会] [[XEP-0143#附录G:备注|4]] 批准. | ||
+ | :* 查看其他标准开发组织开发的协议, 例如[http://www.ietf.org/ 互联网工程工作组(IETF)] [[XEP-0143#附录G:备注|5]]和[http://www.w3.org/ 万维网联盟(W3C)] [[XEP-0143#附录G:备注|6]], 来决定是否它们比在一个新的XMPP扩展里更合适. | ||
+ | :* 查看[http://mail.jabber.org/mailman/listinfo/standards/ Standards SIG] [[XEP-0143#附录G:备注|7]]中的讨论以决定是否过去已经讨论过或目前正在讨论类似的功能. | ||
+ | |||
+ | 在完成这些研究之后, 潜在的作者可以断定是否需要新的协议扩展. 如果需要, 强烈建议该作者做以下事情: | ||
+ | |||
+ | # 查看 '''XEP-0001''' 和 [[XEP-0134|XMPP设计准则]] [[XEP-0143#附录G:备注|8]]. | ||
+ | # 理解[http://xmpp.org/extensions/xep-0143.html#submit 提交过程]. | ||
+ | # 熟悉XEP的XML格式. | ||
+ | # 然后只写一个提案包含所有适当的[http://xmpp.org/extensions/xep-0143.html#sections XEP章节]. | ||
+ | # 查看内容并确保它遵循[http://xmpp.org/extensions/xep-0143.html#styleguide XEP Styleguide]. | ||
+ | |||
==提交提案== | ==提交提案== | ||
==维护XEP== | ==维护XEP== |
2013年4月3日 (三) 02:43的版本
本文的英文原文来自XEP-0143
XEP-0143: XMPP扩展协议作者指南
摘要: | 本文对XMPP扩展协议的作者提供帮助信息. |
---|---|
作者: | Peter Saint-Andre |
版权: | © 1999 - 2013 XMPP标准化基金会(XSF). 参见法律通告. |
状态: | 活跃 |
类型: | 程序 |
版本: | 1.1 |
最后更新日期: | 2011-07-08 |
注意: 这个程序文档定义了一个已经被XMPP委员会和/或XSF董事会批准的XMPP标准基金会(XSF)的流程或活动. XSF目前正是遵循这里定义的流程或活动并且将继续这么做,直到本文档被取消或废除.
目录 |
简介
XMPP标准基金会(XSF) 1 收到大量的提案为XMPP Core 2中定义的核心XMPP协议定义扩展. 然而, 作者们并不总是清楚怎样最佳地结构化一个提案以让它能作为一个XMPP扩展(XEP)被接受并从而进一步通过XSF的标准流程. 所以, 本文提供指南来帮助作者写出更好的XMPP扩展协议定义.
这些指南假定读者们对XMPP扩展协议 3所定义的XEP系列文档和XSF处理它们的流程很熟悉, .
提交提案之前
强烈鼓励一个可能的作者在提交一个提案成为一个XEP之前完成一些研究. 特别是, 该作者应该做以下几件事:
- 查看XMPP RFCs和实验性的, 活跃的, 草案, 和最终XEPs以决定是否真的为了填补现有的XMPP技术和协议的空白而需要该建议的协议扩展.
- 查看被拒绝的和被延期的XEPs, 以及那些永远不会被接受的提案(见 <http://xmpp.org/extensions/inbox/>)来决定是否过去已经有类似的扩展提案但是没有被XMPP理事会 4 批准.
- 查看其他标准开发组织开发的协议, 例如互联网工程工作组(IETF) 5和万维网联盟(W3C) 6, 来决定是否它们比在一个新的XMPP扩展里更合适.
- 查看Standards SIG 7中的讨论以决定是否过去已经讨论过或目前正在讨论类似的功能.
在完成这些研究之后, 潜在的作者可以断定是否需要新的协议扩展. 如果需要, 强烈建议该作者做以下事情:
- 查看 XEP-0001 和 XMPP设计准则 8.
- 理解提交过程.
- 熟悉XEP的XML格式.
- 然后只写一个提案包含所有适当的XEP章节.
- 查看内容并确保它遵循XEP Styleguide.