パラメーターの名前
適切なパラメーター名を選択すると、ライブラリの使いやすさが大幅に向上します。 適切なパラメーター名とは、パラメーターの影響を受けるデータまたは機能を示す名前です。
パラメーター名には Camel 形式を使用します。
パラメーター名には説明的な名前を使用します。
ほとんどのシナリオで、パラメーター名と型を見ただけでパラメーターの使用法が判断できるような名前にする必要があります。
パラメーターの型に基づいた名前ではなく、パラメーターの意味に基づいた名前を使用してください。
通常、パラメーターの型は、開発ツールやドキュメントに表示されます。 パラメーターの使用法や意味を説明する名前を選択することによって、開発者が、タスクに適したメンバーを識別し、適切なデータをメンバーに渡すうえで有益な情報を提供できます。
Portions Copyright 2005 Microsoft Corporation. All rights reserved.
Portions Copyright Addison-Wesley Corporation. All rights reserved.
設計ガイドラインの詳細についてを参照してください、「フレームワークの設計ガイドライン。規則、慣用句、および再利用可能なパターン。ネット ライブラリ」本クシシュトフ Cwalina、ブラッド エイブラムス、アスキー、2005 年発表しました。