Kontrol Versi

Kami menggunakan SVN untuk melakukan kontrol versi basis kode PRADO. Setiap pengembang diberikan akun istimewa untuk mengakses repositori PRADO. Repositori utama pada proyek PRADO ditempatkan di: http://svn.pradosoft.com/repos/prado.

Cabang

Kunci konsep dalam pengembangan dengan kontrol versi adalah branch. Sebuah cabang mewakili sederetan pengembangan untuk keperluan tertentu. Sebagai contoh, sebuah cabang dapat dipakai untuk memelihara revisi kode untuk pengembangan fitur utama.

Cabang dapat digabung bersama pada waktu tertentu untuk membentuk pekerjaan terintegrasi dari pihak-pihak yang berbeda.

Pengembangan PRADO sebagian besar menyangkut tiga jenis cabang:

• main branch: cabang ini berisi seluruh kode dan data dan harus stabil dari waktu ke waktu. Bila diperlukan, sebuah cabang rilis dapat dibuat berdasarkan cabang utama.
• release branch: setiap rilis utama mempunyai cabang seperti itu yang dipakai untuk memelihara rilis. Pembetulan kesalahan untuk sebuah rilis harus diperiksa ke dalam cabang rilis terkait. Rilis minor dapat didasarkan pada cabang rilis bila diperlukan. Cabang rilis juga seharusnya stabil dari waktu ke waktu. Cabang rilis digabung secara reguler ke dalam cabang utama.
• feature branch: Sebuah fitur yang dibuat untuk mengakomodasi pekerjaan pengembangan untuk fitur utama. Cabang fitur tidak perlu stabil. Akan tetapi ketika fitur selesai untuk digabung ke dalam cabang utama, cabang fitur harus dalam status stabil.

Dalam keadaan tertentu, beberapa cabang interim (misalnya cabang gabungan) dapat dibuat untuk keperluan tertentu.

Organiasi Repositori

Berdasarkan klasifikasi cabang di atas, repositori PRADO diatur sebagai berikut:

• trunk: ini adalah cabang utama yang berisi seluruh kode dan data.
• branches: ini adalah folder yang berisi cabang rilis dan cabang fitur. Sebagai contoh, cabang 3.0 dibuat dibuat di bawah folder ini untuk merilis dan memelihara rilis v3.0.x.
• tags: ini adalah folder yang berisi snapshot bernama dari cabang-cabang yang berbeda. Sebagai contoh, tag 3.0.0 dibuat di bawah folder ini yang merujuk ke rilis 3.0.0. Catatan, snapshot BUKAN sebuah cabang. Dalam batasan SVN, sebuah snapshot adalah revisi tertentu.

Bekerja dengan Cabang

Pertama, pastikan pada cabang yang mana anda harus bekerja. Biasanya anda harus bekerja pada sebuah cabang selain cabang utama. Sebagai contoh, ketika anda membetulkan sebuah bug yang ditemukan dalam rilis 3.0.0 atau mengembangkan fitur minor atau peningkatan, anda harus bekerja pada cabang 3.0 (ditempatkan di bawah branches/3.0). Jika anda bekerja pada fitur utama, biasanya ada sebuah cabang fitur untuk itu. Jika tidak, anda dapat meminta untuk pembuatan sebuah cabang fitur.

Kedua, jangan menggabung cabang kecuali anda diperintah untuk melakukannya.

Kriteria Checkin

Kriteria berikut harus diikuti agar dapat memasukan pekerjaan baru,

• Biarkan pengembang lain untuk meninjau pekerjaan baru
• Kirimkan pengujian unit yang relevan
• Kirimkan pengujian fungsionalitas yang relevan
• Pesan singkat yang menjelaskan perubahan yang harus disertakan setiap kali checkin.

Coba untuk TIDAK memasukan jumlah besar pekerjaan sekaligus. Jika anda melakukannya, pastikan kode lulus SEMUA pengujian unit dan fungsionalitas pada SEMUA platform utama yang diklaim bekerja bagi PRADO.

Kekecualian dari kriteria di atas adalah saat mengembangkan fitur baru pada cabang fitur, di mana pemasukan yang sering diperlukan. Akan tetapi, untuk menggabung cabang fitur ke cabang utama, pengujian lengkap dan pembangunan harus dikerjakan.