タグ

2016年6月17日のブックマーク (3件)

  • The Rust Guide (Japanese Translation):前篇 §01-14 - Qiita

    これはRust Guide (0.12.0 nightly) http://doc.rust-lang.org/guide.html の日語訳です。 このページは前半§01-§14の翻訳です。後半§15-§27はhttp://qiita.com/lex_naturalis/items/dbef84b7788efbd30e21 です。 みなさん! Rustガイドへようこそ。Rustでどうやってプログラミングをするかをお知りになりたければ、ここがその場所になります。Rustは「素のハードウェア上での高水準なプログラミング」、つまりプログラミング言語というものに可能な限りで低水準のコントロールを、しかしながら、ゼロコストで高水準の抽象とともに ― というのも人間はコンピューターではないわけですから ― 提供するということにフォーカスした言語です。私達はRustが特別なものだと気で考えています

    The Rust Guide (Japanese Translation):前篇 §01-14 - Qiita
  • phpDocumentorの書き方 - Qiita

    phpDocumentorの書き方ってこれ!っていうベストプラクティスがなくて(ドキュメントとはそういうものなのかもしれないけど…)、毎回試行錯誤して、フォーマットを考えるだけでも時間を取られるので、一度自分なりのフォーマットをまとめたいと思います。 今回は、クラスとメソッドについてまとめています。 プロパティについても書いたほうがドキュメントとしてはよいと思うのですが、プロパティまで書き出すとなかなか継続出来ない(ダメ人間です)ので、追々。。 ちなみに、CakePHPをやんわり想定しています。 では、まずクラスについて。 クラス:フォーマット /** * [区分]クラスの概要 * * クラスの詳細 * 出来るだけ細かく書いたほうがよいが、詳細な説明は各メソッドに任せる。 * 全体での共通ルールとか仕様を書く。 * * @access アクセスレベル * @author 名前 <メールアド

    phpDocumentorの書き方 - Qiita
  • 最低限書いておきたいPHPのDocコメント - Qiita

    最低限書いておきたいというよりは、最低限書いて下さいという私の切なる願いかもしれない。 そもそも何故Docコメントを書くのだろうか? メソッドの命名さえ正確に行えるならDocコメントという存在はほぼ必要無いという考えがあり、 それは間違いでは無いでだろう。 しかし… 型が無いためにメソッド名を冗長にしてしまう 以下のコードは税率を取得するだけの単純なものだ。 TAX::getRate()と実行することで税率を取得出来る。 これなら、主語=TAX、述語=getRateと読み取れるので何をしているのか一目瞭然である。 class Tax { private static $tax_rate = 0.8; public static function getRate() { return self::$tax_rate; } } しかし、これは戻ってくる値の型を予約出来る静的片付け言語であればの

    最低限書いておきたいPHPのDocコメント - Qiita