1

この質問がstackoverflowに当てはまるかどうかは本当にわかりません。そうでない場合は申し訳ありません。このようなQはどこに聞けばいいのか教えていただけると大変助かります。

小さな会社で開発責任者として働いていると、これはいつも私を悩ませます:

「コーディング スタイル」、「命名規則」、および「コードの文書化」について、どの程度主張する必要がありますか?

知っている (そして学んだ) 限り、プログラマーはこれらのこと、特に文書化について思い出されることを本当に嫌います。しかし一方で、これらは多くの点で本当に不可欠です。

4

1 に答える 1

3

いくらにすればいいの...

多くの。

多すぎませんが、十分です。コーディング スタイルと命名規則は、プログラマーが記述するコードの品質の重要な部分です。私がプログラマーを雇うとしたら、次のコード スニペットを書いた 2 人の候補者がいました。

1：

int main(int argc,char*argv[]){
int a=atoi(argv[1]);
int b=atoi(argv[2]);
printf("%d+%d=%d\n",a,b,a+b);
return(0);
}

二：

int main(int argc, char *argv[])
{
    int a = atoi(argv[1]);
    int b = atoi(argv[2]);
    printf("%d + %d = %d\n", a, b, a+b);
    return 0;
}

私は確かに2番目のものを選びます。

ドキュメンテーション？それも非常に重要です。コードは適切に文書化する必要があります-つまり、文書はきれいで簡潔で、適切な英語で書かれている必要があります (「diz funktion iz calculate teh sum of two params」は受け入れられません!)。自明です。

于 2012-10-16T19:34:55.997 に答える