アカウント名:
パスワード:
どんなツールが便利か議論した方がいいでしょう。
VCSを使っているにも関わらず「コードを変更する場合は変更前の部分をコメントで残しておけ」というルールが存在する例もありますよ(汗)。
「コメントアウトのほうが差し戻すときに楽だから」「削除しちゃうと修正前がどんなだったか確認しやすいから」とかいう理由で。
VCSの履歴をコメントに展開してくれるツールがあればいい?
どんな素のエディタでも見えるんなら、コメント化とかなくなるんでしょうけどねぇ...
# VCSが腐ってるやつだと、そうでもせんと危険というのはあって現在進行形# リリースタイミングとかでブラッシュアップできればいいんだろうけど、ねぇ。## そんなタイミングは存在しないのであった。
前にも書いたことがありますが、政府機関にソースを出してバイナリの許認可をもらう業界です。
前回提出ソースからの変更は全て、コメントアウトで残し、必要があります。
それと別に、修正理由も提出しないといけないので……
VCSのヒストリきちんと付けておいて、ヒストリ提出すればいい、という発想はないです。
こっちは機械系で政府に図面を全部出して認可もらう業界…有り体にいっていわゆる防衛産業だけど、昔は図面にすべての変更履歴が観覧できる必要があったけど、今はそんなことないぞ。形体管理する特別な図面以外は書類で確認ができれば(過去の図面が全部残っていて、容易に判別ができれば)問題ないことになってる。
これに組み込むソフトウエアも同様の管理体系だけど問題になってない。未だにそんな感じで管理しているところってどこ?
納品する際に変更履歴をコメントにして追記するツールを作ろう!
前いた職場がVCSを使っているにも関わらず「コードを変更する場合は変更前の部分をコメントで残しておけ」ってところでした。
何度か同じところに修正が入った関数なんて、コメントが並びすぎてわけがわからない。一応、変更前のコードをコメントアウトする場合、その前にコメントアウトしたところももう一層コメントアウトするってルールだったので追えないことはなかったけど、追いたくもない見苦しいコードでした。
そして、そこのコードで見た一番最悪の例が「関数先頭などのdoxygenで拾うコメント文の修正時も修正前をコメントアウトする」。(この時点で意味不明。コメントのコメントアウトって・・・)"/* .. */"って中に"//"でコメントっぽく見えるように書いたり、"// /* "のように最初からコメントアウトしたりする例を見て乾いた笑いしかでませんでした。
そんなことしたらdoxygenの出力結果自体がおかしくなるわ!!(特に前者)そんなルールなのに、詳細設計書はdoxygenで自動生成できます(キリッ はないだろorz
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
皆さんもソースを読むときに、行と行の間を読むような気持ちで見てほしい -- あるハッカー
コメントに変更履歴を残す習慣をなくすには (スコア:1)
どんなツールが便利か議論した方がいいでしょう。
Re:コメントに変更履歴を残す習慣をなくすには (スコア:3)
VCSを使っているにも関わらず「コードを変更する場合は変更前の部分をコメントで残しておけ」というルールが存在する例もありますよ(汗)。
「コメントアウトのほうが差し戻すときに楽だから」「削除しちゃうと修正前がどんなだったか確認しやすいから」とかいう理由で。
theInsiderman(-1:フレームの元)
Re: (スコア:0)
VCSの履歴をコメントに展開してくれるツールがあればいい?
Re: (スコア:0)
どんな素のエディタでも見えるんなら、コメント化とかなくなるんでしょうけどねぇ...
# VCSが腐ってるやつだと、そうでもせんと危険というのはあって現在進行形
# リリースタイミングとかでブラッシュアップできればいいんだろうけど、ねぇ。
## そんなタイミングは存在しないのであった。
M-FalconSky (暑いか寒い)
Re: (スコア:0)
前にも書いたことがありますが、政府機関にソースを出して
バイナリの許認可をもらう業界です。
前回提出ソースからの変更は全て、コメントアウトで残し、
必要があります。
それと別に、修正理由も提出しないといけないので……
VCSのヒストリきちんと付けておいて、ヒストリ提出すればいい、という発想はないです。
Re:コメントに変更履歴を残す習慣をなくすには (スコア:1)
こっちは機械系で政府に図面を全部出して認可もらう業界…有り体にいっていわゆる防衛産業だけど、昔は図面にすべての変更履歴が観覧できる必要があったけど、今はそんなことないぞ。形体管理する特別な図面以外は書類で確認ができれば(過去の図面が全部残っていて、容易に判別ができれば)問題ないことになってる。
これに組み込むソフトウエアも同様の管理体系だけど問題になってない。
未だにそんな感じで管理しているところってどこ?
Re: (スコア:0)
Re: (スコア:0)
納品する際に変更履歴をコメントにして追記するツールを作ろう!
Re: (スコア:0)
前いた職場がVCSを使っているにも関わらず「コードを変更する場合は変更前の部分をコメントで残しておけ」ってところでした。
何度か同じところに修正が入った関数なんて、コメントが並びすぎてわけがわからない。
一応、変更前のコードをコメントアウトする場合、その前にコメントアウトしたところももう一層コメントアウトするってルールだったので追えないことはなかったけど、追いたくもない見苦しいコードでした。
そして、そこのコードで見た一番最悪の例が「関数先頭などのdoxygenで拾うコメント文の修正時も修正前をコメントアウトする」。
(この時点で意味不明。コメントのコメントアウトって・・・)
"/* .. */"って中に"//"でコメントっぽく見えるように書いたり、"// /* "のように最初からコメントアウトしたりする例を見て乾いた笑いしかでませんでした。
そんなことしたらdoxygenの出力結果自体がおかしくなるわ!!(特に前者)
そんなルールなのに、詳細設計書はdoxygenで自動生成できます(キリッ はないだろorz