変更プロセスの概要

GTFS リアルタイムは確定した仕様ではありません。その代わり、交通機関、デベロッパー、その他 GTFS リアルタイムを利用する関係者で構成されるコミュニティによって開発、管理されるオープンな仕様となっています。GTFS リアルタイムの制作者と利用者が参加するこのコミュニティが、新たな可能性を生み出せる仕様に拡張するための提案をしていくことが期待されています。このプロセスを管理していくために、次の手順と基本方針が確立されています。

仕様の修正プロセス

公式の仕様、リファレンス、ドキュメントは英語で作成されています。他の言語への翻訳が英語の原文と一致しない場合は、原文が優先されます。意見の交換はすべて英語で行われます。

  1. Git ブランチを作成して、プロトコルの定義、仕様、ドキュメント ファイル(翻訳を除く)の関連するすべての要素を更新します。
  2. https://github.com/google/transit でプルリクエストを作成します。プルリクエストにはパッチの拡張記述を含める必要があります。プルリクエストの作成者はアドボケートとなります。
  3. プルリクエストが登録されたら、アドボケートは GTFS リアルタイムのメーリング リストでそのことを通知する必要があります。通知されたプルリクエストは提案と見なされます。
  4. アドボケートは投稿者であるため、プルリクエストが承認されるためには投稿者ライセンス契約書に署名する必要があります。
  5. 提案に関するディスカッションを開きます。プルリクエストのコメントは、専用のディスカッション フォーラムで受け付けます。
  6. ディスカッションは、アドボケートが必要と考える限り続けますが、暦日で 7 日間以上続ける必要があります。
  7. アドボケートは、同意したコメントに基づいて提案(プルリクエスト)を適時更新する責任を負うものとします。
  8. アドボケートはいつでも提案の放棄を宣言できます。
  9. ディスカッションに必要な最初の 7 日間を過ぎると、アドボケートはいつでも提案のバージョンに対する投票を呼び掛けることができます。
  10. 投票期間は、暦日で 7 日間、またはスイスの暦で 5 営業日以上とし、23 時 59 分 59 秒(協定世界時間)に終了します。
  11. アドボケートは、投票を開始するときに具体的な終了時刻を通知します。
  12. 投票期間中は、提案に対する編集上の変更のみが認められます(入力ミスのほか、意味が変わらない範囲で表現を変更することができます)。
  13. 誰でもプルリクエストにコメントする形式で賛成または反対に投票でき、投票期間が終了するまで投票を変更できます。 投票を変更する場合は、投票を抹消して新しい投票を作成し、元の投票コメントを更新する形で行うことが推奨されます。
  14. 投票期間が始まる前に行われた投票は考慮されません。
  15. 3 人以上が投票して全員一致で賛成した場合、その提案は承認されます。
  16. 提案者の票は、この 3 票にはカウントされません。たとえば、提案者 X がプルリクエストを作成して賛成に投票し、ユーザー Y と Z が賛成に投票した場合、賛成票は合計 2 票としてカウントされます。
  17. 反対票も役に立ちます。実用的な意見が寄せられれば理想的です。
  18. 投票が成立しなかった場合、アドボケートは提案の意見交換を継続するか、提案を放棄することを選択できます。 どちらの決定もメーリング リストで通知する必要があります。
  19. アドボケートが提案の意見交換を継続した場合は、前回の投票が終了してから暦日で 30 日間以内であれば、いつでも新しい投票を呼び掛けることができます。
  20. 最初に提案が行われてから、または前回の投票が終了してから、暦日で 30 日間以内に投票が呼び掛けられなかった場合、その提案は放棄されます。
  21. 提案が放棄された場合、その提案に対応するプルリクエストはクローズされます。
  22. 提案が承認された場合のプロセスは以下のとおりです。
  23. Google で投票対象のバージョンのプルリクエストをマージします(投稿者が CLA に署名済みの場合)。プルリクエストの処理は 5 営業日以内に行います。
  24. Google で https://github.com/google/gtfs-realtime-bindings レポジトリを適時更新します。提案が gtfs-realtime-bindigs にコミットされた場合、その提案のプルリクエストが参照用に記録されます。
  25. オリジナルのプルリクエストに翻訳を含めることはできません。 サポートされている言語への翻訳については、最終的に Google が責任を持って更新しますが、コミュニティでプルリクエストを純粋に翻訳していただくことは歓迎です。表現に関する変更のコメントがすべて解決されたら、正式な翻訳として認められます。