Itu sangat tergantung pada situasi konkret. Anggap saja properti baru yang Anda tambahkan adalah wajib, artinya properti itu harus selalu disetel. Kemudian Anda harus mencari sendiri melalui kode dan memperbaruinya di mana saja a companyObj
dibuat, untuk memastikan bahwa itu dibangun dengan benar (termasuk mengatur properti baru). Saya berasumsi PHP memiliki konstruktor, dalam hal ini Anda hanya perlu menambahkan parameter konstruktor baru dan kompiler akan secara otomatis menandai setiap panggilan konstruktor tanpa parameter tambahan sebagai kesalahan kompilasi. Ini juga akan memastikan bahwa rekan tim belajar tentang properti baru segera setelah mereka menggunakan a companyObj
.
Namun, jika properti baru itu opsional, semuanya menjadi kurang jelas. Anda mungkin atau mungkin tidak memiliki nilai default yang sesuai untuk itu. Dalam kasus yang terakhir, saya masih menyarankan Anda memperbarui semua kreasi instance untuk mengatur properti baru kapan saja sesuai. Ini untuk memastikan bahwa kode disimpan dalam kondisi yang konsisten setiap saat .
Mengkomunikasikan perubahan kepada rekan setim Anda adalah langkah lain yang jauh di sini. Tim tangkas lebih suka komunikasi tatap muka , dan, IMHO karena alasan yang baik. Mengandalkan dokumen adalah cara yang sangat lambat dan tidak efektif untuk menyebarkan informasi ke seluruh tim. Wiki agak lebih baik, tapi tetap saja, mendokumentasikan setiap atribut kelas tunggal adalah IMHO berlebihan. Itu hanya akan menjadi beban besar bagi tim, dan dengan cepat pasti menjadi tidak dapat diandalkan dan tidak berguna, karena kita adalah manusia sehingga kita terikat untuk melupakan pembaruan kadang-kadang, apalagi saya bertaruh bahwa tidak banyak anggota tim akan secara teratur periksa dokumentasi (baik dalam bentuk apa pun) untuk mendapat informasi tentang perubahan kode terbaru.
Yang terakhir ini juga berlaku untuk dokumentasi yang dibuat secara otomatis melalui misalnya Javadoc atau Doxygen. Meskipun mereka dapat dikonfigurasikan ke dalam bangunan otomatis untuk menjaga agar dokumentasi yang dihasilkan selalu mutakhir, saya belum pernah melihat tim pengembangan dengan anggota yang secara teratur menelusuri dokumentasi untuk mendapatkan informasi tentang perubahan kode terbaru. Dan jika Anda menggunakan sistem kontrol sumber apa pun, tempat pertama yang melihat perubahan adalah ketika Anda memperbarui salinan kode lokal Anda - maka Anda dapat memeriksa perubahan di kelas yang sudah dikenal dan melihat dengan tepat apa dan bagaimana telah berubah (bersama dengan penjelasan singkat dan / atau referensi ke ID tugas, jika tim Anda terbiasa menambahkan komentar check-in yang bermakna - yang akan hilang dari dokumen yang dibuat secara otomatis).
Komunikasi adalah salah satu alasan utama mengapa tim Extreme Programing melakukan pemrograman berpasangan. Jika Anda melakukan perubahan bersama dengan rekan satu tim, ada dua dari Anda segera yang tahu tentang setiap perubahan, dan lain kali Anda masing-masing akan berpasangan dengan orang lain, sehingga informasi yang berguna menyebar dengan cepat. Namun tidak selalu berlaku, karena berbagai alasan. Kecuali itu, Anda mungkin hanya berbicara dengan tetangga Anda tentang perubahan di saat yang tepat (misalnya saat makan siang, jika Anda makan siang bersama), atau mengirim email jika perubahan itu lebih besar, lebih penting atau lebih rumit.
Dalam kasus terakhir, mungkin ada alasan bagus untuk mendokumentasikannya dengan benar. Dokumen desain IMHO adalah yang terbaik ketika mereka menawarkan gambaran kasar tingkat tinggi dari sistem, sementara rincian implementasi ada dalam kode (mengikuti prinsip KERING ).