GTFS Realtime – открытая спецификация, которая создается и поддерживается сообществом транспортных агентств, разработчиков и других сторон, заинтересованных в использовании этого продукта. Предложения по улучшению спецификации должны направляться самими поставщиками и потребителями GTFS. Чтобы помочь им в этом, мы разработали описанные ниже процедуры и рекомендации.
Процесс изменения спецификации
Официальные тексты спецификации, а также сопроводительной и справочной документации составлены на английском языке. Если перевод на другой язык отличается от английской версии, следует руководствоваться текстом оригинала. Вся коммуникация ведется на английском языке.
Создайте ветвь на GitHub и добавьте в нее все обновления разделов определения протокола, а также файлы спецификации и документации. Не прилагайте переводы этих файлов на другие языки.
Создайте pull-запрос на странице https://github.com/google/transit, добавив в него подробное описание патча. После этого автор запроса будет назначен его защитником.
Как только запрос будет зарегистрирован, защитник должен анонсировать его в списке рассылки GTFS Realtime. После этого запрос будет считаться зарегистрированным в качестве предложения.
- Поскольку защитниками pull-запроса могут стать только авторы GitHub, вам потребуется предварительно подписать Лицензионное соглашение для авторов.
После регистрации предложения начинается его обсуждение. В качестве площадки для обсуждения можно использовать только комментарии к запросу.
- Обсуждение длится столько, сколько защитник посчитает необходимым, но не менее 7 календарных дней.
- Защитник несет ответственность за своевременное обновление своих предложений (запросов на включение и пр.) в соответствии с одобренными им комментариями.
- Защитник может в любой момент отказаться от дальнейшей работы с предложением.
Защитник может вынести на голосование уточненную по результатам отзывов версию предложения по истечении первых 7 дней, отведенных на его обсуждение.
Минимальный период голосования составляет не менее 7 полных календарных и не менее 5 полных рабочих дней (по швейцарскому производственному календарю). Голосование заканчивается в 23:59:59 по всемирному координированному времени (UTC).
- В начале голосования защитник должен объявить время его окончания.
- Во время голосования в текст предложения можно вносить только редакторские изменения (исправлять опечатки и улучшать формулировки, не меняя их смысла).
- Любой пользователь GitHub может проголосовать за или против предложения в форме комментария к запросу, а также изменить свое решение до окончания отведенного на голосование времени. Чтобы изменить решение, пользователь должен перечеркнуть первоначальный комментарий и оставить новый.
- Голоса, поданные до начала голосования, при подсчете не учитываются.
Предложение принимается, если не менее трех пользователей выражают свое единодушное согласие с ним.
- Голос автора предложения при подсчете общей суммы голосов не учитывается. Например, если пользователь X создает запрос и голосует за него, а потом свои голоса отдают пользователи Y и Z, считается, что предложение набрало два голоса.
- Голоса против должны подкрепляться мотивировкой и, в идеале, содержать советы, которые помогут защитнику устранить недостатки предложения.
- Если голосование не приносит положительного результата, защитник может либо продолжить работу над предложением, либо закрыть его. О своем решении защитник должен объявить в списке рассылки.
- Если защитник решит продолжить работу над предложением, он может назначить повторное голосование в любой момент, но не позднее чем через 30 календарных дней после окончания предыдущего раунда голосования.
- Если новый раунд голосования не будет назначен в установленный срок, считается, что защитник отказался от дальнейшей работы с предложением.
В случае отказа от предложения соответствующий pull-запрос закрывается.
Если предложение будет одобрено:
- Google сделает все возможное, чтобы в течение пяти рабочих дней включить в спецификацию указанные в запросе изменения (при условии, что его автор подписал Лицензионное соглашение для участников).
- Google сделает все возможное, чтобы своевременно обновить репозиторий https://github.com/google/gtfs-realtime-bindings. Изменения, внесенные в репозиторий в результате одобрения предложения, должны ссылаться на соответствующий pull-запрос.
- В оригинальном pull-запросе не должно быть переводов. Google несет ответственность за добавление переводов на поддерживаемые языки. Однако мы принимаем pull-запросы на перевод от членов сообщества. Они будут рассмотрены после анализа всех замечаний редактора.