[B! coding][codingstyle] manabouのブックマーク

[翻訳] LLVMコーディング標準3.9.1（１/４）：目次＆はじめに - Qiita

コード整形にはclang-formatがいいらしい →ベーススタイルの１つとして、LLVM coding standardsがある →先進的な感じに憧れるが、日本語資料が無いということで、LLVM coding standardsを翻訳してみました。 LLVM3.9.1版のドキュメントを元にしています。新版対応はこちら LLVMコーディング標準原文目次はじめに言語、ライブラリ、および標準 C++標準のバージョン C++標準ライブラリ利用するC++11言語とライブラリの機能その他の言語機械的なソースの問題ソースコードのフォーマットコメントファイルのヘッダクラスの概要メソッド情報コメント書式ドキュメンテーションコメントでのDoxygenの使用 #includeの形式ソースコードの幅タブの代わりにスペースを使うコードインデントの一貫ラムダはコードブロックと

manabou 2017/03/03

リンク

形骸化しないコーディング規約のために - Qiita

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? はじめにコーディング規約を守り続ける、簡単そうでとても難しいことです。数多の宗教論争の末に打ち立てられたコーディング規約が次第に形骸化していくのはとても悲しいことです。なぜコーディング規約を守るのは難しいのか、形骸化させないためにはどうしたら良いか考えようと思います。なぜコーディング規約を守れないのか前述の通り、コーディング規約を守り続けるのはとても困難です。明文化されていたとしても困難ですので、ましてや暗黙の了解のようになってしまっていたらもはや守るのは不可能でしょう。(暗黙的になっている時点で規約としては破綻していると思

manabou 2017/01/25

リンク

コードを書く際の指針として見返すサイトまとめ - Qiita

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

manabou 2016/06/08

リンク

Swiftコーディング規約とコードスニペット

こんにちは。スマートデバイス開発チームの韮澤（にらさわ）です。スマートフォンアプリの開発や開発標準の策定、技術推進などを行っています。私の得意分野はiOS開発なのですが、iOSといえばSwiftの勢いが凄まじいですね。私は先日try! Swiftカンファレンスに参加し、その盛り上がりを肌で感じてきたところです。 Objective-CからSwiftへこれまでiOS開発に使われてきたObjective-Cはその特殊な記法から、学習コストが高く開発を始めるための精神的な障壁が若干高めだったかと思います。しかしSwiftの出現により、プログラミング未経験者はもとよりweb系エンジニアにとっても参入障壁がグッと下がった印象があり、社内でも「SwiftならiOSアプリを書いても良いかも」という意見が聞かれます。そんな高まりを見せるSwiftの波に乗っていこう！ということでリクルートライフ

manabou 2016/04/25

リンク

CoffeeScript スタイルガイドの公開とその目的 - クックパッド開発者ブログ

こんにちは、クックパッド編集室の太田(@os0x)です。普段は料理動画やクックパッドニュースなど、メディア寄りのサービスを担当しながら、社内のCoffeeScriptを中心としたウェブフロントエンドのコードレビューなどを行っています。今回は、そのCoffeeScriptのレビューを円滑に行うためのコーディングスタイルについてお話したいと思います。 Style guides in Cookpad クックパッドでは、github.com上でスタイルガイドを公開しているのをご存知でしょうか？ cookpad/styleguide これまで、Ruby / Objective-C / Java のコーディングスタイルが公開されていました。そして、本日 CoffeeScript のコーディングスタイルを追加しました。さて、そもそもスタイルガイドとはなんでしょうか？コーディング規約とも言われたりし

manabou 2015/04/17

リンク

Ansible コーディング規約 (の例) — そこはかとなく書くよん。ドキュメント

Ansible コーディング規約 (の例)¶ edX がgithub上でAnsibleのコーディング規約を公開しています。 https://github.com/edx/configuration/wiki/Ansible-Coding-Conventions このリポジトリは GNU AGPLv3です。翻訳の場合でもおそらく大丈夫だと思いますので、ここで翻訳して公開してみます。一般¶ YAMLファイルすべてのyamlファイルは2スペースのインデントで、 .yml を拡張子に付けてください。変数 jinja変数の形式を使ってください。 $var ではなく {{ var }} です。 jinjaの変数名の前後に空白を入れてください。 {{var}} ではなく {{ var }} です。環境独自で上書きされる必要がある変数名は全部大文字としてください。ロール内で完結する変数名は全部

manabou 2014/10/09

リンク

コーディング規約を作ろう

コーディング規約を作ろうコーディング規約やスタイルガイドは、HTMLやCSSのマークアップや、各種プログラミング言語の書き方をまとめたものです。コーディングスタンダードやコーディングガイドラインとも呼ばれますね。コーディング規約を決めていなかったり、あいまいにしたまま進めていくと、書式が統一されていないため、コードを追加すればするほどゴチャゴチャしたコードになりがちです。チームでコーディングしていくならなおさら。今回チーム用のコーディング規約を見直すことになったので、その時感じた抑えておくべきポイントをまとめてみます。コーディング規約に含むべき項目ディレクトリー階層ファイルを保存するフォルダーの階層や、そのフォルダーの名前を決めておきます。画像を格納しているフォルダーを例にあげても、「image」「images」「img」などの名前が考えられます。人によってつけるフォルダーの名前が変わっ