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

Question

クラスの元のドキュメントが次のとおりであるとします。 /***My Custom Class** このクラスは、何かを行うのに役立ちます。本当に素晴らしいです。 **著者: David Smith*バージョン: 1.0*/ コードの 50% を書き換えた場合、私の重要な貢献をどのように記録すればよいですか?日付を追加する最良の方法は何ですか?たとえば、コードが最後に変更された日、更新を行った日、バージョンが更新された日などです。

P粉545218185 · Answer

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

リーリー

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

P粉512526720 · Answer

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

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