Я думаю, лучше спросить: "Как написать хорошую спецификацию?" ...
большинство RFC - это плохие спецификации, на мой взгляд ... лично я их очень ненавижу ... они все же лучше, чем спецификации ECMA, но я думаю, что это не настоящий критерий ...
например: сравните JSON- "спецификации" на json.org с фактическим RFC ... я согласен, первое не на 100% точно (ну, на самом деле это точнее, чем большинство кодеров JSON), но в нескольких строках и нескольких синтаксических диаграммах говорится, откуда взялся JSON, как он используется, и определяет формат ...
Я не вижу смысла в написании бесконечных RCF, потому что, в конце концов, никто не читает их, приводя к точке, где
- вы не получите комментарий, запрошенный для
- люди делают реализации, не зная вашего стандарта
если вы действительно хотите предложить стандарт или сделать его понятным, не используйте документы с бесчисленными страницами ... это просто пустая трата времени ... когда стандарт станет зрелым, вы можете начать беспокоиться о создании очень формального и строгое определение, которое является хорошей основой для весьма непротиворечивого поведения во всех реализациях, если это действительно ясно ...
не скрывайте идеи, используя слишком много странных и изобретенных слов, аббревиатур или ссылок на тысячи других вещей ... простота решения - это мера его реальной ценности ... и обращение с читателем вашего документа, как слегка тупой инопланетянин, которому нужно все объяснять, но в то же время ожидать, что они могут следовать неоправданно сложным и раздутым объяснениям, мне не кажется очень вменяемым ... просто KISS ... ;)