Go コードのレビュー時によくされるコメント - GRACEFULEXIT
CodeReviewComments から Go コードのレビュー時によくされるコメントについて。 gofmt gofmt またはそのスーパーセットである goimports を実行すること。goimports は gofmt に加えて import 行の修正も行う。 コメント文 http://golang.org/doc/effective_go.html#commentary を参照。宣言に対するコメントは少し冗長に見えるかもしれないけど完全な文にする。そうすれば godoc できれいに整形される。次のように説明するものの名前から始めピリオドで終える。 // A Request represents a request to run a command. type Request struct { ... // Encode writes the JSON encoding of re
『レトリック感覚』と『レトリック認識』はスゴ本
使い慣れた道具の構造が分かり、より効果的に扱えるようになる。これまでヒューリスティックに馴れていた手段が、一つ一つ狙い撃ちできるようになる。こいつ片手に、そこらのラノベを魔改造したり、漱石や維新を読み直したら、さぞかし楽しかろう。 レトリックというと、言葉をねじる修飾法とか、議論に勝つ説得術といった印象がある。もちろんその通り。アリストテレスによって弁論術・詩学として集大成され、ヨーロッパで精錬された修辞学は、言語に説得効果と美的効果を与える技術体系だ。 だが、「技巧や形式に走る」といって、棄ててしまったのが現代なのだと弾劾する。ものには本名があるから、妙に飾らないで、本名で呼ぶのがいい……そんな俗物的な言語写実主義の教訓が、私たちの楽天的すぎた科学主義=合理主義=実用主義と混ぜこぜになって、言語感覚を狂わせたのだという。 できあいの言語をじゅうぶん便利なコミュニケーションの道具と信じ、形
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
