【发布时间】:2009-09-02 09:31:29
【问题描述】:
我想知道编写针对程序员的标准(例如 JSON)需要什么以及从哪里开始?
有人有这方面的实践经验吗?
【问题讨论】:
-
现在有一个关于重复的答案(比这个晚问)“How to write and propose a RFC?”问题。
我想知道编写针对程序员的标准(例如 JSON)需要什么以及从哪里开始?
有人有这方面的实践经验吗?
【问题讨论】:
我认为,一个更好的问题是,“如何编写一个好的规范?” ...
在我看来,大多数 RFC 都是糟糕的规范……就我个人而言,我非常讨厌它们……它们仍然比 ECMA 规范更好,但我认为这不是一个真正的标准……
例如:比较 JSON-"specs" on json.org 和 actual RFC ...我同意,第一个不是 100% 精确(嗯,实际上它比大多数 JSON 编码器更精确),但只需几行和一个很少有语法图说明 JSON 的来源、用途以及定义格式...
我没有看到写无休止的 RCF 的真正意义,因为最终没有人会读到它们导致的点
如果你真的想提出一个标准,或者让它易于理解,不要使用无数页的文档......这只是浪费时间......当标准成熟时,你可以开始费心制作一个非常正式的文件和严格的定义,这是实现跨实现高度一致行为的良好基础,如果它真的很清楚的话......
不要使用太多奇怪和虚构的词、缩写词或引用成千上万的其他事物来掩盖想法……解决方案的简单性是衡量其实际价值的衡量标准……并善待文档的读者,就像一个有点愚蠢的外星人,你必须向他解释一切,但同时期望他们可以遵循不合理的复杂和臃肿的解释,这对我来说似乎不太理智......只是KISS......;)
【讨论】:
您首先需要的是一个需要一些东西的社区。然后你需要让这个社区进行讨论。
【讨论】: