변경 프로세스 개요

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

사양 수정 프로세스

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

  1. 프로토콜 정의, 사양 및 문서 파일의 모든 관련 부분을 업데이트하여 git branch를 만듭니다(번역 제외).
  2. https://github.com/google/transit에서 pull 요청을 생성합니다. pull 요청에는 패치에 대한 자세한 설명이 포함되어야 합니다. pull 요청 작성자가 지지자가 됩니다.
  3. pull 요청이 등록되면 지지자가 pull 요청 링크와 함께 이를 GTFS 변경사항 메일링 리스트에 발표해야 합니다. 발표된 pull 요청은 제안으로 간주됩니다. 또한 쉽게 교차 참조할 수 있도록 pull 요청을 수정하여 Google 그룹스 알림에 대한 링크를 포함시켜야 합니다.
  4. 제안에 대한 토론이 이어집니다. pull 요청 댓글을 유일한 토론방으로 사용해야 합니다.
    • 토론은 지지자가 필요하다고 생각하는 기간 동안 지속되지만 달력일 기준 최소 7일이어야 합니다.
    • 지지자는 동의한다는 댓글에 근거하여 제안(즉, pull 요청)을 바로 업데이트할 책임이 있습니다.
    • 지지자는 언제든지 제안 포기를 주장할 수 있습니다.
  5. 지지자는 토론에 필요한 최초 7일이 지나면 언제든지 제안 버전에 대한 투표를 요청할 수 있습니다.
    • 투표하기 전에 최소한 1명의 GTFS 제작자와 1명의 GTFS 사용자가 제안된 변경사항을 구현해야 합니다. GTFS 제작자는 공개 GTFS 피드에 변경사항을 포함하고 pull 요청 댓글에 해당 데이터에 연결되는 링크를 제공해야 합니다. 한편, GTFS 사용자는 중대한 방식으로 변경사항을 사용(즉, 새 기능 또는 개선된 기능 지원)하는 애플리케이션에 연결되는 링크를 pull 요청 댓글에 제공해야 합니다.
  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 요청을 이행하기 위해 최선을 다합니다.
    • 번역은 원본 pull 요청에 포함되어서는 안됩니다. Google은 관련 번역을 지원 언어로 업데이트할 책임이 있지만, 커뮤니티에서 pull 요청을 번역할 수 있고 편집상의 모든 댓글이 해결되면 해당 번역이 수락됩니다.
  10. pull 요청의 최종 결과(수락 또는 포기)는 pull 요청이 처음 발표된 동일한 Google 그룹스 대화목록에 발표해야 합니다.