問題タブ [conventions]

私は自分の PHP コーディングを改善しようとしていますが、生産性を向上させたり、PHP の制限を回避したりするために、他のプログラマーがどのような PHP 固有のテクニックを使用しているのか疑問に思っています。

いくつかの例：

1. 名前空間を処理するためのクラス命名規則:Part1_Part2_ClassNameファイルへのマップPart1/Part2/ClassName.php

2. if ( count($arrayName) ) // handles $arrayName being unset or empty

3. 変数関数名、例えば$func = 'foo'; $func($bar); // calls foo($bar);

他のプログラマーに会うことはめったにありません！

トークンを最初に見たときの私の考えは、それが数学的な証明のように読み取られるため、「それを意味する」でしたが、それは明らかにその意味ではありません。

では、「=>」の言い方や読み方は次のとおりです。

それとも、それを言う合意された方法さえありますか？

たとえば、Windows 用の新しいデスクトップ アプリケーションを開発しているとします。すべての Windows アプリケーションがサポートする必要があるキーボード ショートカットのリストを (マイクロソフトまたはサード パーティから) 参照できる場所はありますか?

(注: ここで「すべての Windows アプリケーション」と言うとき、実際には「特定のキーボード ショートカットが有効なすべての Windows アプリケーション」を意味します。たとえば、標準の「デバッグ セッションを開始する」ショートカットは、Visual Studio などの IDE アプリケーション全体で有効です。ただし、メモ帳や Firefox などの他のタイプのアプリケーションには当てはまりません. また、vi など、キーボード ショートカットの独自の完全なカスタム セットを持つ特定の特殊なアプリケーションでは、従う標準的な規則のいくつかに従うことは意味がない場合があります。他のアプリケーションによって。)

たとえば、Windows アプリケーションは次のキーボード ショートカットをサポートする必要があると主張します。これは、他のほとんどのアプリケーションがサポートするデファクト スタンダードであるためです (一部のリストにすぎません)。

どこからでも：

• F1- ヘルプを表示
• Alt+ F4- アプリケーションを閉じる

テキストの編集中:

• Ctrl+ A- すべてのテキストを選択 (該当する場合は現在のフィールド内)
• Ctrl+ Home/ End- キャレットを現在のフィールドの先頭/末尾に移動
• Shift+ [any navigation]- 前のキャレット位置と新しいキャレット位置の間のテキストを選択

編集または名前変更が可能なアイテムが選択されている間:

• F2- 現在のアイテムの名前変更または編集

マルチウィンドウ/マルチタブ アプリケーションで子ウィンドウまたはタブにフォーカスがある場合:

• Ctrl+ F4- 現在のウィンドウ/タブを閉じる
• Ctrl+ W- 現在のウィンドウ/タブを閉じる
• Ctrl+ Tab/ Ctrl+ Shift+ Tab- 次/前のウィンドウ/タブを有効にする

等々。(繰り返しますが、これらはリストの一部にすぎません。事実上の標準のショートカットは他にもたくさんあると思います。)

開発者が、開発中の新しいアプリケーションがサポートする必要があるキーボード ショートカットを決定するための出発点として使用できる、これらのタイプの Windows アプリケーションの事実上の標準キーボード ショートカットのより完全なリストはありますか?

マウスの動作に関する規則の同様のリストも利用できる場合、それは理想的です。(例: 単語をダブル左クリック = 単語を選択)

CSSコードを整理するための形式化されたメソッドを作成する試みはありましたか？読みやすくするための独自の戦略を立てる前に、他に何があるのか​​疑問に思っています。どの用語を検索すればよいか完全にはわからないため、Googleはあまり役に立ちませんでした。

インデント/間隔の線、新しい線をいつ使用するか、命名規則などに沿ってもっと考えています。

何か案は？

誰かがStyleCopと互換性のあるXMLまたは.vssettings-fileでVisualStudioの設定を持っていますか？

MicrosoftがC＃をフォーマットし、それに応じてVisual Studioの設定を設定する正しい方法であると判断したガイダンスについては、「フレームワークの設計ガイドライン：再利用可能な.NETライブラリの規則、イディオム、およびパターン」という本を使用しました。

しかし、Visual Studioで「ドキュメントのフォーマット」を使用すると、StyleCopはすべてのシリンダーで起動し、あらゆる種類のことについて文句を言います。

設定で設定できないエラーもあります。中括弧のように、何かが複数の行にまたがる場合は、新しい行に配置する必要があります。

展開されたpythonアプリケーションをどのように配置するかを考えています

1. /usr/bin/ にある実行可能スクリプトは、に実装されている機能に CLI を提供します。
2. 現在の site-packages ディレクトリがある場所にインストールされるライブラリ。

現在、ソースには次のディレクトリ構造があります。

これは最善の方法ではないと思います。開発中はすべてが期待どおりに機能しますが、展開すると、foo.py の「from foo import FooObject」コードが foo.py 自体をインポートしようとしているように見えますが、これは私が探している動作ではありません。

では、問題は、このような状況を調整する標準的な方法は何かということです。私が考えることができることの1つは、インストール時にfoo.pyの名前をfooだけに変更することです。これにより、それ自体がインポートされなくなりますが、それはかなり厄介なようです...

問題のもう 1 つの部分は、ネーミングの問題だと思います。おそらく、実行可能スクリプト foo-bin.py を呼び出しますか?

素晴らしい本「フレームワーク デザイン ガイドライン」(2008 年 11 月の第 2 版) の付録 A「C# コーディング スタイルの規則」を読んだ後、Microsoft が内部で使用している/推奨しているコーディング スタイルについてかなり混乱しています。

ブログ エントリA Brief History Of C# Styleは次のように主張しています。

実際、「StyleCop スタイル」と「フレームワーク デザイン ガイドライン スタイル」の違いは比較的小さいものです。

私が見る限り、違いはかなり顕著です。StyleCop では、開き括弧は別の行にある必要があると述べていますが、Framework Design Guidelines では、開きステートメントの後にある必要があります。StyleCop では、すべてのキーワードの後に​​スペースが必要であると規定されています。フレームワーク デザイン ガイドラインでは、「すべてのスペースを削除する」(2 項演算子の周りであっても) と規定されています。

フレームワーク設計ガイドラインの本から、このルールは特に皮肉だと思います (366 ページ、上から 6 番目のルール):

フロー制御ステートメントの前にスペースを使用しないでください

これは、StyleCop スタイルが間違っていることを明示的に示しています(while キーワードの後のスペース、等値二項演算子の前後のスペース)。

最後に、StyleCop スタイルを使用してフォーマットされたコードは、フレームワーク デザイン ガイドライン スタイルを使用してフォーマットされたコードとはまったく異なる "感触" を持っています。フレームワーク デザイン ガイドライン スタイルに従うことで、一連のルールを無効にする必要があります (フレームワーク デザイン ガイドライン スタイルへの準拠をチェックするルールはありません...)。

誰か (おそらく MSFT のインサイダー?) が、この相違点に光を当てることができますか?

あなたのチームはこれにどのように対処していますか? StyleCopをフォローしていますか？フレームワークの設計ガイドライン? スタイルを完全に無視しますか？あなた自身のスタイルを焼きますか？

Maven 2 は、プロジェクトに標準のディレクトリ レイアウトを使用します。

http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html

私が疑問に思っているのは、普通のJavaライブラリ、Java EE、およびWebAppプロジェクト以外のプロジェクトに推奨される規則はありますか? 具体的には、ant ファイル、開始スクリプト、構成ファイル、サンプル アプリケーションなどを配置する場所です。

さらに、ファイルを src/ ディレクトリ ツリーの外に配置するための規則は何ですか? たとえば、ドキュメントを doc/ の下 (src の兄弟として) に配置するのは一般的ですか?

これらの規約をまとめたページはありますか? そうでない場合、他の読者が自分のプロジェクトから例を提供できますか?

代替デバイスのアダプティブ レンダリングのメリット以外に、次のコードをすべて記述する意味はありますか。

StringBuilder がこれだけで同じものを構築できる場合:

ビューデータ クラスをコントローラー内にネストしてきましたが、その数が増えるにつれて、これが良いアイデアかどうかを自問し始めています。繰り返しになりますが、/Views および /Controllers ディレクトリをこれらのもので汚染することについては、何かがおかしいようです。

ここで見逃している規則はありますか? おそらく/ViewDataディレクトリですか？idk、viewdata クラスに適した場所はどこですか?