問題タブ [naming-conventions]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
haskell - ヘルパー関数の命名規則は何ですか?
関数型プログラミングでは、末尾再帰になるように「ループ」コードを最適化することが重要な場合がよくあります。ただし、末尾再帰アルゴリズムは通常、基本ケースを設定する関数と実際のループを実装する関数の 2 つの関数に分割されます。(アカデミックではありますが) 良い例は、reverse 関数です。
「reverse_helper」は、実際には適切でわかりやすい名前ではありません。ただし、「reverse_recursive_part」はぎこちないだけです。
このようなヘルパー関数にどの命名規則を使用しますか?
java - Java パッケージの命名規則の失敗
私は Java SE の学習曲線に近づきつつあり、パッケージ名の通常の Java 規則に問題はありません。com.example.library_name_here.package_name_here
を除外する。
よく知られているいくつかのパッケージで、これを順守していないことに気づきました。
- Jライン:
jline.*
- ジェイコブ: ( jacob.com
com.jacob.*
はありません) - JNA :
com.sun.jna.*
(サイトの免責事項には、注: パッケージ名 (com.sun.jna) が別の意味を含んでいる可能性がありますが、Sun はこのプロジェクトのスポンサーではないと書かれています。)
だから私は疑問に思っています、通常の逆ドメイン名の慣習が壊れる例はありますか?それを回避する良い方法はありますか? 私が考えることができる唯一のケースは、ドメイン名の所有権に関する問題です (たとえば、プロジェクトのホスティング/ドメイン名を変更したり、ドメインに対して「不法占拠者の権利」を持つよく知られたパッケージが既に存在する場合や、ドメインの所有権が実行されている場合など)。アウト & 他の誰かがそれをスナップします)。
編集: 会社のドメイン名を使用していて、買収またはスピンオフした場合、パッケージ名はどうすればよいですか? それらを同じままにするか、名前を変更しますか?(パッケージを参照するコンパイルされたクラスが失われるという観点から、名前の変更は悪いと思います)
naming-conventions - クラスやメソッドの命名がプログラミングで最も難しい部分の 1 つだと思う人はいますか?
そこで私は、Web サービスを介してベンダーにヘルプ ドキュメントを要求することになっているこのクラスに取り組んでいます。DocumentRetriever
、VendorDocRequester
、と名付けようとしましたDocGetter
が、正しく聞こえません。私は、適切な単語を見つけようとして、dictionary.comを 30 分間ブラウジングすることになりました。
悪い名前でプログラミングを開始することは、朝の髪の毛が非常に悪い日を過ごしているようなもので、その日の残りはそこから下り坂になります. 私を感じる?
language-agnostic - エンティティ名の頭字語を大文字にする方法は?
少しの間、慣例により、識別子にキャメルケースの単語を使用する言語でプログラミングしていると仮定しましょう。アンダースコアで区切られたメソッド名を持つすべての Ruby 型は、これに座ります。
あなたの名前に頭字語が含まれている場合、最初の文字の後の文字を大文字にするためにどのようなアプローチをとっていますか? たとえば、メソッド createSQLBuffer と createSqlBuffer のどちらを呼び出しますか? この状況で何をすべきかを指示するポリシーはありますか? さらに、どちらか一方を具体的に提唱している記事、または実際にこれをカバーしている記事をリンクしてもらえますか?
私はそれが大したことではないことを知っていますが、何らかの理由で、メソッド/クラス/変数の一方が大文字で、他方がより自然に見えるものに出くわすことがあります。奇妙なことに、一貫性があるかどうかさえわかりません。特定の名前ではすべて大文字を使用し、他の名前では小文字を使用するのが好きだということを知っても驚かないでしょう。
誰もがこれについて意見を共有したいですか?
.net - 抽象クラスの命名規則
かつて、Microsoftが推進したガイドラインは、抽象クラスであるという事実を取り除くために、抽象クラスに「Base」接尾辞を追加することであったことをはっきりと覚えています。したがって、、、、、そしてもちろん、のSystem.Web.Hosting.VirtualFileBase
ようSystem.Configuration.ConfigurationValidatorBase
なクラスがあります。System.Windows.Forms.ButtonBase
System.Collections.CollectionBase
しかし、最近、フレームワークの多くの抽象クラスがこの規則に従っていないように見えることに気づきました。たとえば、次のクラスはすべて抽象的ですが、この規則に従っていません。
System.DirectoryServices.ActiveDirectory.DirectoryServer
System.Configuration.ConfigurationElement
System.Drawing.Brush
System.Windows.Forms.CommonDialog
そして、それは私が数秒でドラムアップできるものです。それで、私は、私が狂っていないことを確認するために、公式文書が何を言っているかを調べに行きました。クラス、構造体、およびインターフェイスの名前は、 MSDNのクラスライブラリ開発の設計ガイドラインにあります。奇妙なことに、抽象クラスの名前の末尾に「Base」を追加するためのガイドラインについての言及が見つかりません。また、フレームワークのバージョン1.1ではガイドラインは利用できなくなりました。
それで、私はそれを失っていますか?このガイドラインは存在しましたか?何も言わずに捨てられただけなのか?過去2年間、私は長いクラスの名前をすべて自分で作成してきましたか?
誰かが私に骨を投げます。
更新 私は夢中ではありません。ガイドラインが存在しました。KrzysztofCwalinaは2005年にそれについて不満を持っています。
naming-conventions - アプリケーションバージョンまたはマイルストーン命名スキーム
アプリケーションバージョンまたはマイルストーン命名の「スキーム」を探しています。
現在のプロジェクトに合ったネーミングスキームを見つけたいのですが、ここにもっと面白いスキームを集めて、このテーマに関する知識やアイデアを共有する必要があると思います。
また、提案されたスキームまたは見積もりで可能な名前の数を提供する必要があります。
例えば :
- OGRE(Object-Oriented-Graphic-Rendering-Engine):各バージョンは、ラブクラフトの「クトゥルフの呼び声」の神話からの「旧支配者」の1つのように名前が付けられています-67の可能な名前。
- Ubuntu(LinuxベースのOS): ここで説明されているように
リリースの開発コードネームは「AdjectiveAnimal」の形式を取ります。たとえば、Warty Warthog(Ubuntu 4.10)、Hoary Hedgehog(Ubuntu 5.04)、Breezy Badger(Ubuntu 5.10)は、Ubuntuの最初の3つのリリースです。一般的に、人々は「いぼ」や「さわやかな」などの形容詞を使用してリリースを参照します。
これにより、有限ですが非常に大きな名前の数が可能になります。
- 一部のハードウェアおよびソフトウェアのリリースは、現実世界の大都市のように名前が付けられています。
- 一部のハードウェアおよびソフトウェアのリリースは、(ギリシャ語-ローマ語-何でも)神話の神または王/武将/皇帝のように名前が付けられています-可能な名前の10分の1が私の神話です。
- 等
私自身のプロジェクトでは、DRY、KISS、YAGNI、Singleton、Factory、Visitorなどの人気のあるソフトウェアの原則/哲学/ルール/パターンのような公開リリースに名前を付けることになる命名スキームを使用することを考えています。少し多すぎる...コンピュータオタク。:)
language-agnostic - キーワードの名前の衝突を避けるためのシステムは何ですか?
通常、言語には、プログラム内の名前 (変数、関数、クラスなど) とまったく同じスペルとケースで直接使用できないキーワードがあります。しかし、何かに名前を付けるための唯一の自然な選択がキーワードである場合もあります。選択したテクノロジーでこの衝突を回避/回避するためのシステムは何ですか?
wpf - textBoxEmployeeName と employeeNameTextBox
どの命名規則を使用していますか?その理由は?
次の理由から、employeeNameTextBox を使用するのが好きです。
- 英語の観点からは、より自然に見えます。
- インテリセンスで調べる方が簡単だと思います。
- この規則は、イベント (MouseClickEvent、MouseClickEventHandler) および依存関係プロパティ (VisiblityProperty) に使用される規則に似ています。
注: 省略形 (「tb」など) ではなくフル ネームを使用しています。これは、省略形の使用を避けるという MS の命名規則に沿っているためです。
xml - XML 要素の標準命名規則はありますか?
XML 文書について、デファクトまたはその他の標準はありますか? たとえば、タグを記述する「最良の」方法はどれですか?
同様に、より良い属性の列挙値がある場合