中の人の徒然草352008-07-09 Wed 19:25
今日は仕事が休みだったのでブログの目次を作ったり、CodeZineの記事の第2回目を編集したり、D言語の仕様を調べたり・・・と色々作業をしました。その過程を通じて得るものが多くありました。
まず目次作りに関してはれいさんからもらったアドバイスです。私の方も色々やったつもりになっていたのですが、やはり書いている本人の主観で分ってても、それが他者にとって分りやすいものでなくては意味がありません。言われてみれば確かに目次があったほうが便利でした。 私自身が愛用する事になりそうです。 次に勉強になったのはCodeZineの記事の編集作業です。 編集者の方はその道のプロなので大変的確な指示をしてくれます。おまけに改稿までしてくれます。 その過程を通じて、技術書的な文章の書き方が学べました。あのような大勢の人に読まれる技術文書は、ブログ・仕事のメール・仲間同士のチャット・等のどれにも該当しない書き方が必要です。 その事が少しだけ理解できました。 他にも細々とした雑感はありますが、あまり書いても冗長過ぎるので以上で終わります。 |
この記事のコメント |
コメントの投稿 |
||
|
|
||
| 管理者だけに閲覧 | ||
|
|
||
この記事のトラックバック |
|
| 無差別に技術をついばむ鳥 |
|