アカウント名:
パスワード:
x = 10; /* x に 10 を代入 */if (a > 0) /* a が 0 より大きい場合 */{....
コードの内容はフィクションですが、ほぼ、こんな感じのソースを実際に見た。
ゆるしてください。
30年程昔に、慣れないCPUの慣れないニモニックを使うアセンブラのソースを解読する時1命令語=1ステートメントごとにコメントを付けたのは、私です。
ソースのファイルサイズが、何倍かに膨れましたが、そのまま残して来ました、もし今でもあのソースをメンテしている人が居たら、ごめんなさい。
組込系やHDL(Hardware Descripition Language)だと、全行にコメントつけることが普通にあるよ念の入ったことにコメントの付け方までコードレビューでチェックすることもあるまあ、ソースの字面だけ見てもそれがどういう意味を持った処理をしているのか理解出来ないコードになることが多いので.........
スパゲッティーなソースを解析してバグを直す仕事を前任者から引き継いだ時、それと同じでした。スパゲッティーなソースの1行1行に、その行の内容が細かく日本語で書かれているというぞっとするソースでした。前任者が解析しながら一生懸命書き込んでいったらしい。
まず最初に前任者が書いたコメントをすべて削除するということから作業を始めました。だってエディタで表示させると、もう視覚的にぐちゃぐちゃで読めないんだもの。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
クラックを法規制強化で止められると思ってる奴は頭がおかしい -- あるアレゲ人
1ステートメント - 1コメント (スコア:1)
コードの内容はフィクションですが、ほぼ、こんな感じのソースを実際に見た。
Re: (スコア:0)
ゆるしてください。
30年程昔に、慣れないCPUの慣れないニモニックを使うアセンブラのソースを解読する時
1命令語=1ステートメントごとにコメントを付けたのは、私です。
ソースのファイルサイズが、何倍かに膨れましたが、そのまま残して来ました、もし今でも
あのソースをメンテしている人が居たら、ごめんなさい。
Re: (スコア:0)
組込系やHDL(Hardware Descripition Language)だと、全行にコメントつけることが普通にあるよ
念の入ったことにコメントの付け方までコードレビューでチェックすることもある
まあ、ソースの字面だけ見てもそれがどういう意味を持った処理をしているのか理解出来ないコードになることが多いので.........
Re: (スコア:0)
スパゲッティーなソースを解析してバグを直す仕事を前任者から引き継いだ時、それと同じでした。
スパゲッティーなソースの1行1行に、その行の内容が細かく日本語で書かれているというぞっとするソースでした。
前任者が解析しながら一生懸命書き込んでいったらしい。
まず最初に前任者が書いたコメントをすべて削除するということから作業を始めました。
だってエディタで表示させると、もう視覚的にぐちゃぐちゃで読めないんだもの。