›プログラミング/コーディングブログ用コーディング規約|プログラミング系記事をスマートに書く目次インデント幅は空白2つ省略できるものはできるだけ書かないヘッダーインクルードを簡潔に表現する出力結果はコード内に書く途中式の扱いマイナス数字の扱い初学者への対応セミコロンは省略しないコメントについてインデント幅は空白2つ画面の小さなモバイル端末を意識し、インデント幅は可能な限り小さくします。タブは使わず空白を用いるようにします。ブラウザによってはタブは空白8つ分の幅で表示されてしまうことがあります。空白の数は2つが理想ですが、4つに慣れているユーザを考慮し、少し広めの3つ指定という選択もあります。上級者向けの記事や階層が深めのコードでは空白2つを用い、初心者向けの記事では3〜4の空白を用いるのも良いでしょう。省略できるものはできるだけ書かない上級者・中級者向けの記事ではヘッダーのインクルードやライブラリのインポート、main関数等は必要に応じて書くようにし、可能な限り省略するようにします。3.1);}本当に伝えたい重要な情報のみを載せるようにします。コード量は少ないほうが読む側の負担も減ります。重要な情報を相手に印象づける効果も生まれます。余計なネストも不要になり、コードの行数も削減できます。読者ターゲットに合わせてコードを書くよう意識しましょう。ヘッダーインクルードを簡潔に表現する特定のライブラリの関数や定数の説明を行う際には、ヘッダーのインクルードをきちんと行います。2);}サンプルコードが冗長的になる場合には、コメントを用いて補足的な記述を行います。2);必要に応じ、インクルード元で利用している関数や定数をコメント形式で記述します。対象の機能がどのヘッダで定義されているかが明確となります。DBL_EPSILON)出力結果はコード内に書くプログラムの出力結果はコード内にコメントとして埋め込みます。99"初心者向けの記事の場合は、よりわかりやすくするために詳細なコメントを付け加えるのも良いでしょう。99"場合によっては表形式にしたほうが読みやすくなります。15色々と工夫すると良いでしょう。2}途中式の扱い必要であれば、計算結果や途中式の結果もコード内に埋め込みます。"103"マイナス数字の扱い数字部分を揃えます。-2147483648初学者への対応コード内に処理の結果をコメントとして埋め込むという発想は、初学者を混乱させる恐れがあります。"9"補足を加えることでこれを解消することもできます。9式形式のコメントを記述することも有効です。9モバイル環境での表示を考慮し、ヨーダ記法による記述を行うことも有効です。iモバイル環境ではワードラップ無効時にコードが途中で途切れてしまうことがありますが、ヨーダ記法を用いれば重要な結果(9)の部分が途切れずに表示される確率が高まります。ヨーダ記法とは|定数を左辺に記述するメリットと流行らない理由コードを揃える規則性の見出しやすいコードを書くためのテクニックです。2;このように似たような処理が複数あるような場合は、それぞれの代入位置やキーワードの位置を揃えるようにします。これによってそれぞれの処理が共通した処理や関連した処理/宣言であるということを読み手に示すことができます。このようなコード整列は、右辺と左辺の対応を明確にする意図もあります。可読性や判読性が向上し読み手の負担も軽減する利点が生まれます。NGconsole.log("Pen-Pineapple-Apple-Penpineapple-Pen")画面の小さなモバイル端末ではテキスト折り返しによってコードが改行されて表示される事があります。複数コードが改行無しで書かれているような場合には複数行の判別が難しくなります。セミコロンを付けることで、文の終わりを明確にする意図があります。Swift言語やJavaScript言語ではセミコロンの省略ができますが、文字数の多い行では可能な限りセミコロンを付けるようにすると良いでしょう。セミコロンを省略する場合は改行を適宜用いるようにします。これらの問題はCSSでテキスト折り返しを無効にすることで対処も可能です。コメントについてコメント内で変数名を利用する場合にはシンボル名をバッククオート(`)で囲います。