Javadocを書く - しげるメモ
最近は時間を作ってEffective Javaの2版をよんでます。 Effective Java (Java Series) 作者: Joshua Bloch出版社/メーカー: Prentice Hall発売日: 2008/05/08メディア: ペーパーバック購入: 6人 クリック: 65回この商品を含むブログ (42件) を見る ほとんど1版と同じ内容ですが、"Item 44: Write doc comments for all exposed API elements" を読んでよくまとまってるなと思ったので、触発されてメモがてらに私のやり方を。 引用の2段落目は基本的に超約。 どこに書くか If an API is to be usable, it must be documented. ユーザが利用可能なすべてのAPIにJavadocを書く。 これはとりあえず必須だと思います。ち
フューチャリスト宣言の通り、学校制度は終わってる気がする。 - 高校生奮闘記
教育フューチャリスト宣言という本がある。そこで脳科学者の茂木健一郎さんという方が『大学というシステムが終わっていることは体感でわかるんですよ。』と言っていた。そのときは言いすぎだろうとも思ったが、考えるとやっぱりそんな気がしていた。そして今日、現代文の授業を受けていて切に思った。「こんな授業意味ねぇ！」と。意味がまったくないとまではいわないが、とんでもなく非効率なことをしているのは確かだと思う。たとえば、現代文の授業は現状どのように行われるかを見てみると、大方が、まず読む教材を全員に配る。朗読する。この部分は何故こうなのか？どういう意味なのか？みたいな問いかけがなされる。その問いかけに関して生徒が考えて答える。先生がそこを黒板で解説する。細かい差はあると思うが、大方の授業はこの流れだろうと思う。まず僕が異を唱えたいのは５の部分、書かれた文章について教師が解説するといっても、果たしてその解説
まともな日本語書いてこやんかい！ - やねうらおブログ(移転しました)
最近、本の監修やら何やらで他人の書いた文章をチェックすることが多いのだが、「まともな日本語書いてこやんかい！」と叫びたくなることがある。 いままで日本の国語教育では一番大切なことを教えてこなかった。 どういう文章が分かりづらく、読みづらい悪文なのかということについてだ。 その結果、かなり教養のある人ですら、全く自覚のないまま、読み手のことを考えてない、非常に読みづらい文章を生産し続ける。 彼らは、同一格助詞がいくつも連続していても気にもとめない。主語を省略して、その主語を一つの文の途中で他の主語に入れ替えても、それが読みづらい原因であることを理解できない。*1 正しくくびき構文を使えていない。*2 係り結びが離れすぎる。*3 指示語が指す内容が一意に定まらない。指示語が指す内容が複数形なのに「これ」とか書いてある。(「これら」と書くべきだ。) 指示語の指す内容が遠く離れ過ぎている。(文章を
株式投資正統派 文章が下手なあなたへ
03 - 1999.11.30 今回は、株とはまったく関係ない『文章』の書き方について能書きをたれます。 同じ文章を書くのなら、できるだけわかりやすい文章を書きたいものです。わかりにくい文章は困りますよね。例として、以下の文を読んでください。 ホームページにＣＧＩ設置したいけれども、なかなか難しくて手間をかける方は、掲示板、ゲストブック、カウンターアクセス統計などの設置が今日から簡単です。今すぐフリー登録して見ませんか？ ご満足いただけると思います。 これは、アクセスカウンターや掲示板を無料で提供してくれるＪ機関のＨＰ説明文です。分かる人には分かります。しかし、インターネットを始めてまもない方には難しい文章です。間違いなく、下手な文章です。私が以下のように書き換えてみました。 . 自分のホームページに掲示板、ゲストブック、アクセスカウンターを設置したいけれど、なかなか難しくて大変だというあ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ERROR 404 - PAGE NOT FOUND