Cara menggunakan phpDocumentor untuk merekod kemas kini kod dan tarikh untuk pengarang yang berbeza

Question

Andaikan dokumen asal sesuatu kelas adalah seperti berikut:

/**
 * 我的自定义类
 *
 * 这个类帮助你做一些事情。它真的很棒。
 *
 * 作者：David Smith
 * 版本：1.0
 */

1. Jika saya menulis semula 50% kod, bagaimanakah cara saya merekodkan sumbangan penting saya?

2. Apakah cara terbaik untuk menambah tarikh? Contohnya, tarikh terakhir kod diubah suai, tarikh saya membuat kemas kini atau tarikh versi dikemas kini.

Answer 1

Satu pendekatan yang saya lihat dalam syarikat yang saya telah bekerja selama ini ialah melakukan ini:

/**
 * 我的自定义类
 *
 * 这个类可以帮助你做一些事情。非常好用。
 *
 * 作者：David Smith
 * 版本：1.0
 *
 * 修改者：Rahul Parkar
 * 修改日期：09/11/2012
 */

Selain itu, saya juga melihat bahawa mereka menggunakan dua kaedah untuk merekodkan perubahan, satu adalah menggunakan cara seperti Git di mana setiap komit mempunyai mesej komit, dan satu lagi adalah menggunakan tag dokumen lain untuk merekodkan perubahan.

Answer 2

Saya tahu saya tidak betul-betul menjawab soalan anda, tetapi saya ingin tahu sebab anda masih menggunakan @pengarang.

Jika anda ingin menjejaki perubahan pada kod anda (siapa yang mencipta fail? Siapa yang mengubah suainya?), gunakan sistem kawalan versi anda. Lagipun, untuk itulah :)