Как написать хороший стандарт RFC и с чего начать? - PullRequest
2 голосов
/ 01 сентября 2009

Мне было интересно, что требуется для написания стандарта, предназначенного для программистов (например, JSON) и с чего начать?

У кого-нибудь есть практический опыт?

Ответы [ 2 ]

2 голосов
/ 01 сентября 2009

Я думаю, лучше спросить: "Как написать хорошую спецификацию?" ...

большинство RFC - это плохие спецификации, на мой взгляд ... лично я их очень ненавижу ... они все же лучше, чем спецификации ECMA, но я думаю, что это не настоящий критерий ...

например: сравните JSON- "спецификации" на json.org с фактическим RFC ... я согласен, первое не на 100% точно (ну, на самом деле это точнее, чем большинство кодеров JSON), но в нескольких строках и нескольких синтаксических диаграммах говорится, откуда взялся JSON, как он используется, и определяет формат ...

Я не вижу смысла в написании бесконечных RCF, потому что, в конце концов, никто не читает их, приводя к точке, где

  • вы не получите комментарий, запрошенный для
  • люди делают реализации, не зная вашего стандарта

если вы действительно хотите предложить стандарт или сделать его понятным, не используйте документы с бесчисленными страницами ... это просто пустая трата времени ... когда стандарт станет зрелым, вы можете начать беспокоиться о создании очень формального и строгое определение, которое является хорошей основой для весьма непротиворечивого поведения во всех реализациях, если это действительно ясно ...

не скрывайте идеи, используя слишком много странных и изобретенных слов, аббревиатур или ссылок на тысячи других вещей ... простота решения - это мера его реальной ценности ... и обращение с читателем вашего документа, как слегка тупой инопланетянин, которому нужно все объяснять, но в то же время ожидать, что они могут следовать неоправданно сложным и раздутым объяснениям, мне не кажется очень вменяемым ... просто KISS ... ;)

0 голосов
/ 01 сентября 2009

Первое, что вам нужно, это сообщество, которому что-то нужно. Тогда вам нужно обсудить это сообщество.

...