변경 프로세스 개요

GTFS Realtime 사양은 확정되지 않았습니다. 대신 GTFS를 사용하는 대중교통 기관, 개발자 및 기타 이해관계자로 구성된 커뮤니티에서 개발 및 유지하는 공개 사양입니다. GTFS 데이터의 제작자와 사용자로 구성된 커뮤니티는 새로운 기능을 구현하기 위해 사양 확장을 제안할 것으로 예상됩니다. 해당 프로세스를 관리하기 위해 다음 절차 및 지침이 마련되었습니다.

사양 수정 프로세스

공식 사양, 참조자료 및 문서는 영어로 작성됩니다. 다른 언어로 된 번역이 영어 원본과 다른 경우 영어 원본이 우선합니다. 모든 커뮤니케이션도 영어로 진행됩니다.

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