Ringkasan Proses Perubahan

Spesifikasi GTFS tidak bersifat permanen. Justru spesifikasi ini bersifat terbuka yang dikembangkan dan dijaga oleh komunitas perusahaan transportasi umum, developer, dan pemangku kepentingan lainnya yang menggunakan GTFS. Komunitas produsen dan konsumen data GTFS ini diharapkan nantinya memiliki proposal untuk memperluas spesifikasi tersebut sehingga memungkinkan adanya kemampuan baru. Untuk membantu mengelola proses tersebut, prosedur dan panduan berikut telah ditetapkan.

Proses perubahan spesifikasi

Spesifikasi, referensi, dan dokumentasi resmi ditulis dalam bahasa Inggris. Jika terjemahan ke dalam bahasa lain berbeda dari versi aslinya dalam bahasa Inggris, versi bahasa Inggris yang akan diutamakan. Semua komunikasi dilakukan dalam bahasa Inggris.

  1. Buat git branch dengan update semua bagian file definisi protokol, spesifikasi, dan dokumentasi yang relevan (kecuali untuk terjemahan).

  2. Buat permintaan pull di https://github.com/google/transit. Permintaan pull harus berisi deskripsi patch yang lengkap. Pembuat permintaan pull menjadi advokat.

  3. Setelah terdaftar, permintaan pull harus diumumkan oleh advokatnya di milis Perubahan GTFS, termasuk link ke permintaan pull tersebut. Setelah diumumkan, permintaan pull dianggap sebagai proposal. Permintaan pull juga harus diedit untuk berisi link ke pengumuman Google Grup agar mudah direferensikan silang.

  4. Kemudian, diskusi proposal dilakukan. Komentar permintaan pull harus digunakan sebagai satu-satunya forum diskusi.

    • Diskusi dilakukan selama diperlukan oleh advokat, namun setidaknya harus berlangsung selama 7 hari kalender.
    • Advokat bertanggung jawab untuk ketepatan waktu update proposal (yaitu permintaan pull) berdasarkan komentar yang mereka setujui.
    • Advokat dapat mengklaim bahwa proposal diabaikan kapan saja.
  5. Advokat dapat meminta pemungutan suara untuk versi proposal kapan saja setelah interval 7 hari awal yang diperlukan untuk diskusi.

    • Sebelum meminta pemungutan suara, setidaknya satu produsen GTFS dan satu konsumen GTFS harus menerapkan perubahan yang diusulkan. Produsen GTFS diharapkan menyertakan perubahan feed GTFS untuk publik dan memberikan link ke data tersebut dalam komentar permintaan pull, dan konsumen GTFS diharapkan menyediakan link dalam komentar permintaan pull ke aplikasi yang menggunakan perubahan tersebut secara signifikan (dengan kata lain, mendukung fungsi baru atau yang disempurnakan).
  6. Pemungutan suara berlangsung selama periode minimum yang cukup untuk mencakup 7 hari kalender penuh dan 5 hari kerja penuh Swiss. Pemungutan suara berakhir pada pukul 23:59:59 UTC.

    • Advokat harus mengumumkan waktu berakhir yang spesifik di awal pemungutan suara.
    • Selama pemungutan suara, hanya perubahan editorial pada proposal (kesalahan ketik, susunan kata dapat diubah selama tidak mengubah artinya) yang diizinkan.
    • Setiap orang diizinkan untuk memberikan suara ya/tidak dalam bentuk komentar untuk permintaan pull, dan suara dapat diubah sampai akhir periode pemungutan suara. Jika pemilih mengubah pilihannya, sebaiknya perbarui komentar yang asli dengan mencoret pilihan dan menulis pilihan yang baru.
    • Suara yang diberikan sebelum periode pemungutan suara dimulai tidak dihitung.
  7. Proposal diterima jika terdapat konsensus bulat untuk memilih ya dengan minimal 3 suara.

    • Jumlah total 3 suara ini tidak termasuk suara pemohon proposal. Misalnya, jika Pemohon Proposal X membuat permintaan pull dan memberi suara ya, dan Pengguna Y dan Z memberi suara ya, berarti total suara untuk ya adalah 2.
    • Suara yang tidak setuju sebaiknya diberikan motivasi, dan idealnya ada masukan yang dapat ditindaklanjuti.
    • Jika pemungutan suara tersebut gagal, advokat dapat memilih untuk terus menyempurnakan proposal, atau mengabaikan proposal. Apa pun keputusan advokat harus diumumkan di milis.
    • Jika advokat memilih untuk terus memperbaiki proposal, pemungutan suara baru dapat diminta kapan saja, tetapi tidak boleh lebih dari 30 hari kalender setelah pemungutan suara sebelumnya berakhir.
    • Jika pemungutan suara tidak diminta dalam waktu 30 hari kalender sejak proposal pertama atau 30 hari kalender sejak pemungutan suara sebelumnya berakhir, proposal tersebut akan diabaikan.
  8. Jika proposal diabaikan, permintaan pull yang sesuai ditutup.

  9. Jika proposal diterima:

    • Google berkomitmen untuk menggabungkan versi permintaan pull berdasarkan hasil suara (asalkan kontributor telah menandatangani CLA), dan melakukan permintaan pull dalam waktu 5 hari kerja.
    • Terjemahan tidak boleh disertakan ke dalam permintaan pull asli. Google pada akhirnya bertanggung jawab untuk memperbarui terjemahan yang relevan ke dalam bahasa yang didukung, tetapi terjemahan asli permintaan pull dari komunitas diperbolehkan dan akan diterima segera setelah semua komentar editorial ditangani.
  10. Hasil akhir permintaan pull (diterima atau diabaikan) harus diumumkan di rangkaian pesan Google Grup yang sama tempat permintaan pull tersebut diumumkan pertama kali.