GTFS Realtime 사양은 확정된 것이 아니며, 대중교통 기관, 개발자 및 GTFS Realtime을 사용하는 기타 이해관계자로 구성된 커뮤니티에서 개발 및 유지하는 공개 사양입니다. GTFS Realtime 데이터의 제작자와 사용자로 구성된 이 커뮤니티에서 새로운 기능을 구현하기 위해 사양 확장을 제안할 것으로 예상됩니다. 관련 프로세스를 관리하기 위해 다음 절차 및 지침이 마련되었습니다.
사양 수정 프로세스
공식 사양, 참조자료 및 문서는 영어로 작성됩니다. 다른 언어로 된 번역이 영어 원문과 다른 경우 영어 원문이 우선합니다. 모든 커뮤니케이션이 영어로 진행됩니다.
프로토콜 정의, 사양 및 문서 파일의 모든 관련 부분을 업데이트하여 git branch를 만듭니다(번역 제외).
https://github.com/google/transit에서 pull 요청을 생성합니다. pull 요청에는 패치에 대한 자세한 설명이 포함되어야 합니다. pull 요청 작성자가 지지자가 됩니다.
pull 요청이 등록되면 지지자가 GTFS Realtime 메일링 리스트에 이를 발표해야 합니다. 발표된 pull 요청은 제안으로 간주됩니다.
- 지지자는 참여자이므로 pull 요청을 수락하기 전에 참여자 라이선스 계약에 서명해야 합니다.
제안에 대한 토론이 이어집니다. pull 요청 댓글을 유일한 토론방으로 사용해야 합니다.
- 토론은 지지자가 필요하다고 생각하는 기간 동안 지속되지만 달력상 7일 이상 진행되어야 합니다.
- 지지자는 동의한다는 댓글에 근거하여 제안(즉, pull 요청)을 신속하게 업데이트할 책임이 있습니다.
- 지지자는 언제든지 제안 포기를 주장할 수 있습니다.
지지자는 토론에 필요한 처음 7일이 지난 후 언제든지 제안된 버전에 대한 투표를 요청할 수 있습니다.
투표는 최소한 달력상 7일, 스위스 영업일 기준 5일을 포함하는 기간 동안 지속됩니다. 투표 마감 시간은 UTC 23:59:59입니다.
- 지지자는 투표가 시작될 때 구체적인 종료 시간을 발표해야 합니다.
- 투표 기간 중에는 제안서에 대한 편집상의 변경(오타 수정)만 허용됩니다. 문구 변경은 의미가 바뀌지 않는 범위 내에서만 가능합니다.
- 누구든지 pull 요청에 대해 댓글 형식으로 찬성/반대 의사를 표시할 수 있으며, 투표 내용은 투표 기간이 지속되는 동안에는 변경 가능합니다. 투표자가 투표 내용을 변경하려는 경우에는 원래의 투표 댓글을 업데이트(선을 그어 기존 투표 내용을 지우고 새로 투표 내용 작성)하여 변경하는 것이 좋습니다.
- 투표 기간 시작 전에 실시된 투표는 인정되지 않습니다.
투표자가 3명 이상이고 만장일치로 찬성하는 경우 제안이 수락됩니다.
- 제안자의 투표는 투표 결과가 인정되는 데 필요한 총 3표에 포함되지 않습니다. 예를 들어 제안자 X가 pull 요청을 만들어 찬성으로 투표하고 사용자 Y와 Z가 찬성으로 투표를 하면 총 찬성 투표수는 2표로 계산됩니다.
- 반대표는 이유를 밝혀야 하고, 가능하면 실행 가능한 의견을 제공해야 합니다.
- 투표가 성립되지 않으면 지지자는 제안 작업을 계속하거나 제안을 포기할 수 있습니다. 지지자가 어떤 식으로 결정하든 해당 내용은 반드시 메일링 리스트에 발표해야 합니다.
- 지지자가 제안 작업을 계속한다면 이전 투표가 끝난 후 달력상 30일 이내에 새로운 투표를 요청할 수 있습니다.
- 최초 제안 후 30일 이내에 또는 이전 투표 종료 후 30일 이내에 투표를 요청하지 않을 경우 제안이 취소됩니다.
제안을 포기하면 해당 pull 요청이 종료됩니다.
제안이 수락되는 경우
- Google은 (참여자가 콘텐츠 라이선스 계약에 서명한 경우) 투표를 통해 선택된 pull 요청을 반영하고 영업일 기준 5일 이내에 pull 요청을 이행하기 위해 최선을 다합니다.
- Google은 https://github.com/google/gtfs-realtime-bindings 저장소를 적시에 업데이트하기 위해 최선을 다합니다. 제안의 결과인 gtfs-realtime-bindig를 시행하기 위해 최선을 다하며 제안의 pull 요청을 참조해야 합니다.
- 원본 pull 요청에 번역이 포함되어서는 안 됩니다. Google은 관련 번역을 나중에 지원 언어로 업데이트할 책임이 있지만, 커뮤니티에서 pull 요청을 번역할 수 있고 편집상의 모든 의견이 처리되면 해당 번역이 수락됩니다.