Pregunta

Me preguntaba lo que se requiere para escribir un estándar que se dirige a los programadores (por ejemplo JSON) y por dónde empezar?

¿Alguien tiene experiencia práctica en eso?

¿Fue útil?

Solución

creo, una mejor pregunta es, "cómo escribir una buena especificación?" ...

Los más RFC son malas especificaciones, en mis ojos ... personalmente, i bastante los odio ... son aún mejores que ECMA-especificaciones, pero eso no es un verdadero criterio creo ...

Por ejemplo: comparar JSON- "especificaciones" en la json.org con el real RFC ... Estoy de acuerdo, el primero no es 100% exacta (bueno, en realidad es más exacta a continuación la mayoría de los codificadores JSON), pero en algunas líneas y unos diagramas de sintaxis que dice dónde proviene de JSON, lo que su uso es, y define el formato ...

No veo un punto real en la escritura sin fin FCR, porque en el extremo nadie lee lo que lleva al punto donde

  • usted no recibe el comentario que ha solicitado para
  • personas hacen implementaciones sin saber realmente su nivel

si realmente quiere proponer un estándar, o hacerlo comprensible, no utilice documentos con un sinnúmero de páginas ... es sólo una pérdida de tiempo ... cuando el estándar es madura, puede empezar a molestar a hacer una muy formal y definición estricta, lo cual es una buena base para un comportamiento altamente consistente al otro lado de las implementaciones, si es muy claro ...

do ideas no oscuros usando demasiados extraño e inventado palabras, abreviaturas o refiriendo a muchas más cosas ... la simplicidad de una solución es una medida de su valor real ... y tratar el lector de su documento, como un extranjero poco tonto, a los que hay que explicar todo, pero al mismo tiempo, esperando que puedan seguir las explicaciones complejas y injustificadamente hinchado, no parece muy sano para mí ... sólo Kiss ...;)

Otros consejos

Lo primero que se necesita es una comunidad que necesita algo. Luego hay que conseguir esta comunidad discutir.

Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top