phpDocumentor を使用してコードの更新とさまざまな作成者の日付を記録する方法

Question

クラスの元のドキュメントが次のとおりであると仮定します。

リーリー

1. コードの 50% を書き換えた場合、重要な貢献をどのように記録すればよいですか?

2. 日付を追加する最良の方法は何ですか?たとえば、コードが最後に変更された日、更新を行った日、バージョンが更新された日などです。

Answer 1

私が長年働いてきた会社で見てきたアプローチの 1 つは、次のとおりです。

リーリー

さらに、変更を記録するために 2 つの方法を使用していることもわかりました。1 つは、各コミットにコミット メッセージを持つ Git のような方法を使用する方法で、もう 1 つは、別のドキュメント タグを使用して変更を記録する方法です。

Answer 2

あなたの質問にあまり答えていないのはわかっていますが、なぜあなたがまだ @author を使用しているのか知りたいです。

コードへの変更を追跡したい場合 (ファイルを作成した人? 変更した人?) は、バージョン管理システムを使用してください。結局のところ、それが目的です:)