textdrop

『コントリビュータのためのAndroidコードスタイルガイドライン 日本語訳』

Android Open Source Project の Code Style Guidelines for Contributors の日本語訳です。

http://source.android.com/ のリニューアルに伴い、レイアウトと前文のところが若干変更していたので、アップデートしました。

更新履歴:
2010-07-14 最新版に更新
2010-05-21 文体見直し
2009-03-31 若干手直し
2009-01-04 ひとまず公開

もしおかしなところなどありましたらご指摘いただけると助かります。

Google Objective-C Style Guideのバージョンが2.18に上がっていたので「Google Objective-Cスタイルガイド日本語訳」をアップデートしました。文体も見直しました。

ChangLogによると、変更箇所は以下の通り。

• @optionalが使えるときには、非公式プロトコルではなく@optionalを使う方が望ましい
• メソッド呼び出しの書式を追加
• レビューしやすくするためにdeallocに要件を追加

Google C++ Style Guideのバージョンが3.154から3.161に上がったので『Google C++スタイルガイド 日本語訳(全訳)』をアップデートしました。

主な変更は以下。

• “and”のような演算子の同義語を使うことを禁止した
• 失敗時にクラッシュする関数に使う命名規約（OrDie）を明記した
• static const データメンバが非プライベートであることを許した
• フレンド宣言を置く場所を明記した
• 各ファイルで使うヘッダをインクルードすることを要求した

『Google XML文書フォーマットスタイルガイド 日本語訳』

Google XML Document Format Style Guideを訳してみました。

XML文書を設計するときには、どうするのがよいのか結構迷いますが、これはひとつの指針として参考になるのではないかと思います。

おかしなところなどありましたらご指摘ください。

更新履歴:
2010-05-12 公開 (r22)

ライセンスはオリジナルと同じくCC-By 3.0 Licenseです。

Google Objective-C Style Guideのバージョンが2.14に上がっていたので「Google Objective-Cスタイルガイド日本語訳」をアップデートしました。

ChangLogによると、変更箇所は以下の通り。

• パラメータのインデントについて4番目のルールを追加した。最初のキーワードが短いメソッドの場合には、2つの形式のどちらかを許すようにした。
• BOOL対boolの指針について更新した。
• 空白をきれいにした。

Google C++ Style Guideのバージョンが3.146から3.154に上がっていたので『Google C++スタイルガイド 日本語訳(全訳)』もアップデートしました。

主な変更は以下。

• 使ってもよいboostライブラリにcall_traitsを追加
• デフォルト引数のルールに例外を追加
• マクロで##を使うことを推奨しない、など

あと読みにくいところなど、ちょこちょこと手を入れました。

Google C++ Style Guideのバージョンが3.133から3.146 に上がっていたので『Google C++スタイルガイド 日本語訳(全訳)』もアップデートしました。

ChangLogによると、変更箇所は以下の通り。

• 有害なコンストラクタは許されない、というメッセージをより明確にした。古いコードを書き直す必要はないが、新しいコードには DISALLOW_COPY_AND_ASSIGN を使うべきである。
• イニシャライザリストをコンストラクタイニシャライザリストに変更した。誰もがコンストラクタの一部だということをわかった上で検索しているようだが、正確な名前を忘れてしまうためだ。
• test fixtureのデータメンバがprivateであることを許した。
• グローバル変数に関する制約を緩和した。
• ネストされた名前空間の書式に関して、明確なガイドラインを追加した。
• operator&のオーバーロードの禁止について補足した。
• ファイル名には “-” よりも “_” を推奨することを追加した。
• 「コピーコンストラクタ」のセクションを改訂して、より簡潔に明確にした。非標準のコピー操作よりも標準の方が望ましいことを強調した。
• 「コンストラクタでやるべきこと」の表現を弱めて、複雑な初期化にはInit()メソッドが絶対必要というわけではないことを明確にした。
• typoや文法間違いを修正した。

あと読みにくいところなど、ちょこちょこと手を入れました。

Google Objective-C Style Guideのバージョンがいつの間にか2.12に上がっていたので「Google Objective-Cスタイルガイド日本語訳」を一応アップデート。
変更はeditorialなものだけです。

Google Objective-C Style Guideのバージョンが2.11 に上がっていたので「Google Objective-Cスタイルガイド日本語訳」もアップデートしておきました。

主な変更箇所は

• #import と #includeに関するガイドラインを追加
• リビジョン番号が付いた

といったところ。

Google C++ Style Guideのバージョンが3.127から3.133 に上がっていたので「Google C++スタイルガイド日本語訳」もアップデートしておきました。

主な変更箇所は

• 「グローバル変数」のところが「スタティック変数とグローバル変数」になって説明がわかりやすくなった
• enum値の命名規則に定数スタイル(kEnumName)を追加

といったところ。
あと読みにくいところなど、ちょこちょこと手を入れました。