タグ付けされた質問 「coding-standards」

コーディング標準またはコーディング規約は、ソフトウェアプロジェクトでのコード生成のプロセスを管理するために設計された一連のルールまたはガイドラインです。それらは通常、業界のベストプラクティスまたは一般に受け入れられている規則に基づいています。これには、命名規則、スタイル、禁止されている機能などが含まれます。

14
レガシーコードを渡したときに、独自のコーディングバイアスをどのように克服しますか?[閉まっている]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 4年前に閉鎖されました。 プログラマとして、私たちはしばしばスキルに信じられないほどの誇りを持ち、「良い」コードと「悪い」コードとは何かについて非常に強い意見を持っています。 私たちのキャリアのどの時点でも、おそらくいくつかのレガシーシステムがラップに落ちていて、「このコードはダメだ!」それは、完全に機能的で保守可能なコードである可能性が高いにもかかわらず、優れたコードがどうあるべきかという概念に適合しなかったためです。 他のプログラマーの仕事を回避しようとするとき、どのように精神的に準備しますか?

6
科学的コードは、一般的なコーディング標準を無視するのに十分な領域ですか?
最近、次の事実について心を包もうとしています。 一方では、「健康」、「クリーン」、「よく書かれた」などのコードと見なされるものについて、コーディングのガイドラインと標準が多数あります。ここでも広く議論されているように見える「クリーンコード」を参照してください。ルールの例:7行の長いメソッドと1または2レベルのインデント。従わないコードは、どういうわけか保守性が悪いために死ぬことが予想されます。 一方で、OpenCV、OpenCascade、VTKなどと連携するようになりました。これは科学的なコードです。彼らは2ページの長いメソッドを持っています(私自身)、OpenCascadeには10個のファイルに分割されたメソッドまたはクラスがあります(ここではジョークはありません)、VTKも混乱することがあります。しかし、これらのプロジェクトは繁栄し、維持され、広く使用されています! キャッチはどこですか?科学的で数学が重いコードを、それが機能するように書くことは許されていますか?あなたは、もしあれば、そのようなプロジェクトのための独立した標準のセットですか? 素朴な質問かもしれませんが、私は物事を行う方法としない方法を設定しようとするプログラミングの無効のようです。これは高校で働くことを教えられた方法です。私は卒業して以来、私がやらなければならないこと、主にプログラミングについてのガイドラインのサポートがほとんどありませんでした。

11
コーディングのベストプラクティスを常に使用する必要があります[終了]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 閉じた3年前。 ソフトウェアをコーディングする場合、構築するアプリケーションに関して、アーキテクチャは常にベストプラクティスまたは実践的プラクティスのどちらである必要がありますか? 5年間存続する可能性のある2ページのWebアプリケーションを構築し、その5年間で2つの機能拡張を行う場合、依存性注入、デザインパターン、ビューモデルを備えたモデルビューコントローラーなどでコーディングする必要があります

1
Bootstrap 3がcamelCaseをダッシュ​​に変更する理由-読みやすいですか?
すべてのラクダケース名を v3.0でハイフン付きの名前に変更するというBootstrapの決定の背後にある理由は何なのでしょうか。私はグーグルで検索し、数冊の本を調べましたが、私はどちらかの方法しか意見を見つけることができません-確かなデータはありません。 キャメルケースの変数名がダッシュよりも読みやすいことを示唆する研究はありますか、それとも個人的な好みの問題ですか?

13
抽象クラスに「抽象」プレフィックスを追加する必要がありますか?[閉まっている]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 5年前に閉鎖されました。 という名前の抽象クラスがあるとしTaskます。 AbstractTask代わりに名前を付けることを提案する標準または規則はありますか?

8
C#-フィールドのプレフィックスが推奨されないのはなぜですか?
昔、私たちはハンガリー語表記をしていました。これは今ではpasséと見なされており、ほとんどの場合はもう使用していませんが、m_メンバーフィールドを示すためにプレフィックスを使用することはまだあります。 私にとって、他の誰かのコードを読んでいると、私はこれを見る: count = 3; 私はそれcountがその関数のローカル変数であると仮定し、関数の他の場所で使用される何かをしています。私がこれを見たら: m_count = 3; オブジェクトの状態を更新していることにすぐに気付きます。 マイクロソフトのスタイルガイドラインでは、それが物事を行う間違った方法であると述べています。関数内で定義された一時変数とまったく同じ非公開フィールドに名前を付けることになっています。いいえm_、単純なアンダースコアですらありません。 はい、独自のコーディングスタイルを定義することはできますが、その後、さまざまな静的コード分析ツールに取り組み、物事のやり方が問題ないことを説得する必要があります。 マイクロソフトのスタイルに変更できてうれしいですが、なぜそうなっているのかを知りたいです。 変数が関数ローカルであるかメンバーであるかを判断できるのはなぜ悪いと考えられるのですか? PSこれは、C#のフィールドとメソッドの前にある「this」キーワードに関して現在考えられているベストプラクティスと非常に似ていますか?、しかし私は聞いてm_いないthis. PPSまた、Microsoftがパラメーター、ローカル変数、およびプライベートフィールドに同じ名前の命名規則を付けた理由を参照してください。

3
小さなオープンソースのJavaプロジェクトに選択するパッケージ名は何ですか?[閉まっている]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 4年前に閉鎖されました。 Javaで小さなオープンソースライブラリを公開したいと思います。どのパッケージ名を選択すればよいのでしょうか?私は会社ではなく、命名規則に従ってパッケージの命名の基礎として使用できるドメインがありません。それでも、偶然の衝突を防ぎ、物事を標準に保つために、どういうわけか命名規則に従いたいと思います。

9
強制コード再フォーマットの利点と欠点
この質問は、Software Engineering Stack Exchangeで回答できるため、Stack Overflowから移行されました。 8年前に移行され ました。 私は現在、開発者にバージョン管理チェックインで自動コードフォーマッタを使用するように強制することを検討している場所で作業しています。私はこれを行うことの利点と欠点について開発者の意見を探しています...あなたがそれがどのように開発者を助けるか妨げると思うか。私の特定のケースはJava / JSPに関係していますが、質問はどの言語にも当てはまると思います。

11
推奨される.NET / C#コーディング標準?[閉まっている]
現在のところ、この質問はQ&A形式には適していません。回答は、事実、参考文献、または専門知識によってサポートされると予想されますが、この質問は、議論、議論、世論調査、または広範な議論を求める可能性があります。この質問を改善し、場合によっては再開できると思われる場合は、ヘルプセンターをご覧ください。 6年前に閉鎖されました。 ロックされています。この質問とその回答はロックされています。なぜなら、質問はトピックから外れていますが、歴史的に重要だからです。現在、新しい回答やインタラクションを受け入れていません。 .NET / C#プロジェクトにとって、どのコーディング標準が重要だと思いますか?これは、そのような中括弧と間隔とペダントリーを扱うことから何でもありえます。または、.NET Frameworkのどの名前空間を避けるべきか、構成ファイルのベストプラクティスなど、より基本的な質問になる可能性があります。 単純に別の投稿である投稿を作成しないようにしてください。たとえば、中括弧に焦点を当てた投稿が1つあればよいでしょう。一方のスタイルと他方のスタイルをサポートするために2つは必要ありません。アイデアは、ペットの基準に投票することではなく、基準を作成する際に考慮すべきことを具体化することです。

15
私たちのコーディング標準の1つが嫌いで、それは私を狂気にさせます、それをどのように処理するのですか?[閉まっている]
現在のところ、この質問はQ&A形式には適していません。回答は、事実、参考文献、または専門知識によってサポートされると予想されますが、この質問は、議論、議論、世論調査、または広範な議論を求める可能性があります。この質問を改善し、おそらく再開できると思われる場合は、ヘルプセンターをご覧ください。 6年前に閉鎖されました。 免責事項:タイトルが示すほど誇張されていませんが、それでも私を不快にします。私は正直に言いたいだけなので、一粒の塩でそれを取る。私が話しているコーディング標準について話しているふりをしてください。 編集:私はそれが好きではないという事実は、私はそれを使用したり、それを強制しないことを意味するものではありません。 私は、あなたが好きではない標準を乗り越える方法の精神でこの質問をすることを決めました、それがどのように変更できるかをよりよく議論する方法の助けを得るためではありません(この最後の部分に関するコメントは大歓迎です)。その上、私は大企業で働いていますが、これほど長く生きてきて、ほとんど問題にならないような変化は起こりそうにありません。 標準は、専用線の開始中かっこ標準です。 somefunction() { //... } *明らかに優れた*の代わりに(冗談/欲求不満の音に注意してください): somefunction() { //... } 標準に対する私の個人的な主張: コードが肥大化する:余分な不要な行 入力が難しい:これはおそらく私が標準に苦労しているだけかもしれませんが、余分なキーストロークがそれほど悪くないことは知っています。 読みにくい:関数宣言、ifステートメント、または他のスコープスタッキングステートメントの読み取りを開始しますが、開き括弧を探す必要はありません。この標準のネストされたブロックは、何らかの理由で私を怒らせます。 Microsoft IDEのバックグラウンドから来た人々が使用します。パラダイムによってそれを取り入れるだけでなく、標準の背後にある議論された理由(またはそれ以上)があるべきだと思います。 彼らの議論(および内部的に彼らに反論する私の方法): ブロックの開始位置と終了位置がすぐにわかるので読みやすくなります。ブロックの所有者がわからない場合、ブロックの良さはわかりません。逆読みする必要があります。 私はMicrosoft IDEでそれを使用し、それが好きでした:うーん...大丈夫? それは標準にあります:* cringes * 私は特定の基準に対して意見を述べる姿勢に苦しんでいる唯一の人ですか?、これらをどのように乗り越えましたか?この特定の基準がどうあるべきかについてのあなたの意見は何ですか?

5
よく知られているPowerShellのコーディング規則はありますか?
PowerShellでプログラミングする場合、明確に定義された規則はありますか? たとえば、長期的に維持されるスクリプトでは、次のことを行う必要がありますか? 実際のコマンドレット名またはエイリアスを使用しますか? コマンドレットパラメーター名を完全にまたは部分的にのみ指定します(dir -Recurse対dir -r) コマンドレットの文字列引数を指定するときは、(引用符で囲みますNew-Object 'System.Int32'対New-Object System.Int32 関数とフィルターを作成するとき、パラメーターのタイプを指定しますか? (公式の)正しいケースでコマンドレットを作成しますか? のようなキーワードのBEGIN...PROCESS...END場合、大文字のみで記述しますか? MSDNにはPowerShellのコーディング規約ドキュメントが欠けているようですが、そのようなドキュメントはC#などに存在します。

8
マイクロソフトがパラメーター、ローカル変数、プライベートフィールドに同じ名前の命名規則を付けたのはなぜですか?
かなり前にこの質問をしました:C#でプライベート変数にどのように名前を付けますか? 回答の1つで、プライベート変数/フィールドは次のように命名する必要があることを示すMicrosoftのMSDNページを指摘されました。 private int myInteger; ただし、パラメーターは次のようになります。 void SomeMethod(int myInteger) ローカル変数は次のようになります。 int myInteger; このように参照すると myInteger = 10; あなたが話しているものを知る方法はありません。 現在、私は新しいプロジェクトを開始していますが、同僚の1人が、少なくともこれらのいくつかを差別化するために何もしないのかと尋ねてきました。 私は同じことを疑問に思っています。なぜマイクロソフトの標準はこれらを異なっていなかったのですか?

9
開発者が自分のワークステーションで作業する方法の標準
開発者がプロ​​ジェクトの途中で数日間病気になったときに時々起こるような状況に出くわしたばかりです。 彼が自分のコードの最新バージョンをコミットしたのか、それとも私たちが見なければならないローカルマシンに何か新しいものがあるのか​​どうかについていくつかの質問がありました。彼が戻ってくる。 他の開発者の1人が彼としてログオンして、多くが同じプロジェクトのように見えるワークスペースを見つけて、どれが「現在」であるかが不明確になったタイムスタンプを見つけました(彼は、彼の「コア」1)。 明らかにこれは首の痛みですが、代替策(各開発者が最小の労力で物事を拾うことができるように各開発者が自分のマシンでどのように動作するかについての厳格な基準のようです)開発者の個人的な作業が流れ、個人レベルでの非効率につながります。 私は、チェックインコードの標準や、一般的な開発標準についても話していません。開発者がローカルでどのように動作するかについて話しているのです。 それでは、このような状況をどのように処理しますか?開発者に支払う代価は、彼らに最適な方法で作業することを許可されているのか、あなたが対処しなければならないことの1つですか? または、開発者にこの分野の標準(特定のディレクトリの使用、標準の命名、Wiki上のメモなど)を遵守するよう依頼しますか?もしそうなら、あなたの基準は何をカバーしていますか、それらはどれくらい厳格ですか、どのようにそれらを取り締まりますか? または、私が見逃している別の解決策はありますか? [議論のために、開発者は彼がここで何をしているのかを話すために連絡できないと仮定します-メモリからどのワークスペースがどれであるかを知って記述できたとしても、単純で完璧ではない場合があります連絡しないでください。すべての不測の事態をカバーするソリューションが欲しいです。] 編集:誰かのワークステーションを通過するのは悪い形だと思います(それはなぜ興味深いのか、おそらくトピック外の質問です)、そして無制限のアクセスを見ていません。コードディレクトリが読み取り専用共有でセットアップされている標準のラインに沿ってもっと考えてください-何も変更できず、他に何も見えません。

8
Systems Hungarianの魅力は何ですか?[閉まっている]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 5年前に閉鎖されました。 でガイドラインを命名何が続くのですか?、著者は言います: また、Charles Simonyiのハンガリー記法を使用してコーディングすることを好みます。 私は、ハンガリー語を使用することを好む複数のプログラマーに出会ったことがありますが、その多くはペツォルド/システムズのハンガリー語です。考えてくださいdwLength = strlen(lpszName)。 私は間違ったコードを間違って見えるようにしましたが、ドメイン名の情報が変数名に含まれているApps Hungarianの原理を理解しています。しかし、コンパイラー型を名前に付加することの価値は理解していません。 なぜプログラマーがこのスタイルの表記法を使用し続けるのですか?それは単なる慣性ですか?可読性の低下を上回る利点はありますか?人々はコードを読むときにデコレータを無視することを学ぶだけなのでしょうか? 編集:多くの答えが歴史を説明している、またはなぜそれがもはや関連していないか、両方とも私が引用した記事でカバーされています。 私はまだそれを使用している世界中の誰からも聞きたいです。なぜそれを使用するのですか?それはあなたの標準にありますか?不要な場合は使用しますか?新しいプロジェクトで使用しますか?利点は何ですか?

9
コードフォーマットのガイドラインはどれくらい重要ですか?[閉まっている]
閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか?この投稿を編集して事実と引用で答えられるように質問を更新してください。 6年前に閉鎖されました。 コーディング標準はどのソフトウェア開発組織でも一般的ですが、それに従うことはどれほど重要ですか?ある程度の一貫性の必要性は理解できますが、ブレースの位置、行の長さなどの単純なものを扱う場合、過度に厳しい標準がソフトウェア開発に大きく寄与するかどうかはわかりません。 事前定義された標準に準拠しているのではなく、コードが読みやすいことが重要ではありませんか?とにかくガイドラインに似ているようです。

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.