2010年8月26日 (木)ワタシ、ハズ、ガンバッタ、キット
結論:ただのゴミでした。(何が?って人はこっちも読んでね)
おはようございます。
過去の遺物をゴミ箱に放り込んだ、プログラマーのN.Iです。
…ガンバった、ガンバったんです。
でも!
あんなのもう見たくも無いわぁぁぁぁぁ!
ゴミだ、ゴミ。
楽せず一から作った方が、実は楽だったって昔の偉人も言ってます。
という訳で、ネタが無くなってしまいました。
コレガホントノ、ミッカボウズ、ハハハーワラエネェ。
プログラム話をしたいのは山々ですが、
最近やったことといえば、ウインドウ表示のみ。
原点回帰と言えば聞こえは良いですが、ただの復習ですから…
さて、どうしたものか。
あぁ、そうそう。
そういえば最近、説明書なるものを書いてます。
説明書というより、メモ書きに近いですが。
作ったツールとかを他人が使う際に、これさえ読めば大丈夫!
て言えるようにする為のモノです。いわゆる"readme"ってヤツですな。
これが中々難しいのですよ。
何が難しいって、相手に伝わる文章を書かないといけないんですよ!?
こんなのすらすら書ける人達が、ほんっとーにうらやましぃ。
私には無理だーっ!
声を高らかに叫びたい気持ちで一杯です。
このブログですら四苦八苦してる、しがないプログラマもどきが
そんなのすらすら書ける訳ないじゃないですか…。
なので、"わかりやすい文章"で検索検索っと。
困った時のweb頼み、です。
適当に見たページで書かれてたことを要約すると
①何を書けばいいのか考えて
②それを箇条書きにする
③あとは、細かく説明していくだけ
らしいです。
なるほど、つまり今回の説明書でいうと…
①機能毎に一つの項目であると考えて
タイトルやら簡単な概要を記述する
②各機能に関連する、説明事項を
小項目として列挙する
③後は、小項目の詳細を記述するだけ!
④ついでに、項目全体での補足とか
別の項目との関連など、ゴニョゴニョすればなお良し!!
って訳ですな。
(見た目)簡単そうじゃーないですか。
これなら、しがないプログラマもどきでも楽々ですよ。
と思いきや。
ゴニョゴニョしてたら、内容が膨らみすぎてわけわかんね~よ。
って状態です。
どうやら、文章をまとめるということから始めないといけない模様。
完成までの道のりは長そうです。
誰でも良いから、
もっと効率の良い"解りやすい文章"の書き方
ってヤツを教えて下さい。10分ぐらいで。
え?
そもそも理解の仕方が間違ってるんじゃないかって??
…ソンナコト、ナイナイ、キット。
| 固定リンク | コメント (0) | トラックバック (0)
「プログラマー」カテゴリの記事
- 技術交流の業(2019.03.07)
- 福袋争奪戦デビュー(2019.01.31)
- 温泉旅行(2019.01.24)
- ゲーセンの近況(2018.11.29)
- 健康的にプログラミングを続けるためのちょっとした習慣(2018.10.18)
この記事へのコメントは終了しました。
コメント