如何编写一个好的RFC标准以及从哪里开始?

时间:2009-09-01 14:08:01

标签: standards rfc

我想知道编写一个针对程序员的标准(例如JSON)需要什么以及从哪里开始?

有没有人有这方面的实践经验?

2 个答案:

答案 0 :(得分:2)

我认为,一个更好的问题是,“如何编写一个好的规范?” ...

大多数RFC都是糟糕的规格,在我看来......个人而言,我非常讨厌它们......它们仍然比ECMA规格更好,但我认为这不是真正的标准......

例如:将JSON-"specs" on json.orgactual RFC进行比较...我同意,第一个不是100%完全(实际上它比大多数JSON编码器更准确),但是在几行和一些语法图表说明JSON的来源,用途是什么,并定义格式......

我没有看到写无尽的RCF的真正意义,因为最终没有人读到它们导致了

  • 您没有收到您要求的评论
  • 人们在不了解您的标准的情况下进行实施

如果你真的想提出一个标准,或者让它易于理解,不要使用无数页面的文件...这只是浪费时间......当标准成熟时,你可以开始打扰一个非常正式的和严格的定义,如果真的很清楚,这是实现高度一致行为的良好基础......

不要通过使用太多奇怪和发明的词语,删除或引用成千上万的其他东西来掩盖想法......解决方案的简单性是衡量它的实际价值的一种方法......并且对待文档的读者,就像一个有点愚蠢的外星人,你必须向他们解释一切,但同时期望他们可以遵循不合理的复杂和臃肿的解释,对我来说似乎不太理智......只是KISS ...;)

答案 1 :(得分:0)

您需要的第一件事是需要某些东西的社区。然后你需要让这个社区讨论。