問題タブ [code-standards]

私は、適切な名前間隔で JavaScript モジュール パターンを練習してきました。したがって、基本的には名前空間を宣言し、各名前空間にはカプセル化された特定のモジュールがあります。ここまで書いてきた内容です。コードは適切にコメントされています。

誰でも理解できるように、このコードに完全にコメントしました。単純な名前空間を宣言し、その中にモジュールを追加します。もちろん、モジュールはカプセル化を使用しています。

私のインストラクターの 1 人は、このコードには基本的な欠陥の基準があるかどうかを示唆しています。コードは正常に実行されますが、これを理解できません。

それは標準的な賢明さで十分ですか？それとも私はそれを完全に間違っていますか？

これら 2 つの PHP クラス メソッドは、 phpmd ルールのbooleanargumentflagに従って、Single Responsibility Principle (SRP)に違反しています。

これを回避するにはどのように記述すればよいでしょうか。

解決策がデフォルト値「= true」を削除することである場合、これによりコードはどのように改善されますか?

IntelliJ IDEA の更新バージョンを使用しており、特定のプロジェクトに取り組んでいるすべての開発者が使用できるように、コード スタイルの設定をエクスポートしようとしています。https://confluence.jetbrains.com/display/IntelliJIDEA/Code+Stylesおよびhttp://forum.shakacode.com/t/sharing-your-intellij-rubymine-webstorm-codestyle-among-developersでチュートリアルを読みました/240、かなり単純に見えます。

残念ながら、私の「エクスポート設定」ペインはそうではなく、「コード スタイル」という行もありません。私のように見える

私が見つけることができる最も近いのは、CodeStyleSettingsManager が他の多くのものとともに含まれている強調表示した行です。しかし、私はそれを使ってみて、.jar ファイルを抽出しただけで、内部には何もないことがわかりました。

IntelliJ の最新バージョンで動作するコード スタイルをエクスポートする方法を知っている人はいますか?

編集: 私の codeStyleSettings.xml ファイルには、次のもののみが含まれています。

以下の例のように、メソッド間でオブジェクトを渡し、データを追加する必要があります。以下に書かれたコードは良いプログラミングの実践ですか?

Groovy または Java のクラスまたはメソッドの場合、API レベルのドキュメントは通常、通常のコメントではなくドキュメント コメント (別名 Javadoc コメント) に含めます。Groovy スクリプトについてそのようなコメントを追加する類似の方法は何ですか?

個人的には、Javadoc ツールがドキュメントを取得するかどうかはあまり気にしません。ただし、Groovy スクリプトの目的に関するドキュメントは、クラスのドキュメント コメントに概念的に類似しているように見えます。したがって、私は直感的にそれらがドキュメントのコメントにあると期待しています。私の直感が間違っていて、doc タグが Groovy スクリプトの意図をコメントする標準的な方法ではない場合、スクリプトの目的を文書化するための推奨される方法は何ですか?

私は Doctrine を使用しており、PHP に次の行があります。

複数の呼び出しで回線を設定するためのコード標準があるかどうかを知りたいです。Symphony と他の PSR のいくつかを調べましたが、これに固有のものは見つかりませんでした。

上司のプレゼンテーション用にコードを書かなければなりません。最終的には、技術担当者とソフトウェア エンジニアがコードを確認します。彼は私にそれを完璧にしてプロフェッショナルに見えるようにしてほしいと思っています (私はプロフェッショナルに見えませんか??)。

この書き方を考えてみましょう:

これで問題なくコンパイルできると思いますが、変数の命名、アンダースコア付きのプレフィックス、クラス構造などに関しては、競合するリソースがたくさんあります。私はいくつかの調査を行い、それは私をより混乱させました。結局のところ、それは単なる意見ベースのスタイルまたは個人的な視点であることはわかっていますが、私はこの問題を乗り越えるための SO コミュニティしか持っていません。

• 推奨事項のレイアウトには、「プライベートクラス変数にはアンダースコアサフィックスが必要です」と記載されています
• アンダースコアに関するルールの高評価の回答は、 「アンダースコアで変数を開始しない」と述べており、受け入れられた回答は「すべてのアンダースコア変数は予約されています」と述べています。
• 命名規則で受け入れられた回答は、「C++では、アンダースコアは通常、プライベートメンバー変数を示します」と述べています
• 先頭のアンダースコアの意味で、コンストラクターのパラメーターにアンダースコアが付けられていることがわかります
• cpp 変数の命名には、「_ SUM: C++ 言語では最初の位置にアンダースコアを使用できます」と記載されています。

別のスタイルは次のとおりです。

最新の質問/回答はおそらく 5 年前のものです (実際には関係ありません)。しかし、この問題に関する率と回答を確認したいと思います。いつ使う_variable？いつ使うvariable_？いつ使うvariable？いつ使うm_variable？データがなくても (「空」のようにprotected)、常にクラス構造に従う必要がありますか? 変数名とクラス名が大文字または小文字になるのは、いつ、なぜですか? プロのプログラマー/開発者は、上記のサンプル コードをどのように記述しますか?

「この問題では両方の言語が同じ標準を持っていると思うので、C# を追加しました」

PHP が非常にエラー耐性の高い言語であることは知っています。それが、次のような関数呼び出しに混合変数を使用できる理由だと思います。

そのような混合変数を使用しない推奨される方法はありますか?

私自身のプロジェクトでは、後でエラーが発生する問題を減らし、コードを明確にするために、このような混合変数を避けるようにしています。

PHP 7 では、この関数が期待する変数の型を宣言できるはずですよね? これはどのように行われますか？