佐藤竜一『エンジニアのためのWord再入門講座　美しくメンテナンス性の高い開発ドキュメントの作り方』

エンジニアのためのWord再入門講座美しくメンテナンス性の高い開発ドキュメントの作り方

posted with amazlet at 12.07.17

佐藤竜一
翔泳社
売り上げランキング: 52738

サヨナラ、Excel方眼紙、くたばれ、Excel方眼紙！！、ということで、業務でバリバリExcel方眼紙を使っている立場からすれば耳が痛いような内容の本……ではあるが、とにかく序盤はExcelはキレイなレイアウトでドキュメント（文書）を書くためのアプリケーションではないのであーる！！という分かりきったようなdisりに徹しているものの、Wordでキレイなドキュメントを作る方法については中途半端。たしかにExcelにはWordのような段落番号だの、自動で番号を割り振る機能だのがないけれども、達人Excel VBAerであれば、そうした機能を盛り込んだハイパーExcel方眼紙を作っていてもおかしくない。Wordの機能の斬新な使い方が紹介されているわけでもなく、これならヘルプを見れば良いのでは……。

私もExcel方眼紙で目次情報などを抽出できるプログラムを組み込んだ設計書のひな形を提供して、それで仕事をしてもらったりするし……。文字の位置情報のコントロールがたぶんExcelのほうが簡単なので、そういうのをやるならWordでドキュメントを書く方が効率が良くない感じもある。よって、本書の主張はそんなに心に響かなかった。紹介されているWordの機能についてもなんだか中途半端。これはやはりWordの中途半端さなのであって、論文などには向いているのかもしれないけれど、システム開発のドキュメント作成にはあんまりイケてないんじゃないの……？

こうした「ドキュメント、どうする？」という話については各社お悩みのところかと思う。「どういうドキュメントが必要か」というのも各社・各業界で違うので「どういう風にドキュメントを作れば良いのか」という本は難しそう。

で、この本は、完全に「どういう風にドキュメントを作れば良いのか（キレイな体裁でドキュメントを作るには？）」という本である。そもそも、ドキュメントっているの？コードが読めないクソなヤツらのためにそんなもん作っても、どうせコードが読めないクソはドキュメントだって読まないよ！（読めないよ！）などという根本的な話も議論を呼ぶところだと思うので、ますます「どういう風に」は難しい。コードで良い部分と、ドキュメントじゃなきゃいけない部分、その辺の切り分けすら、スタンダードなやり方がないような気がするので、まずは「エンジニアのためのドキュメント作成再入門」が必要な気がする。

このブログの人気の投稿

石野卓球・野田努　『テクノボン』

テクノボン posted with amazlet at 11.05.05 石野卓球野田努 JICC出版局売り上げランキング: 100028 Amazon.co.jp で詳細を見る石野卓球と野田努による対談形式で編まれたテクノ史。石野卓球の名前を見た瞬間、「あ、ふざけた本ですか」と勘ぐったのだが意外や意外、これが大名著であって驚いた。部分的にはまるでギリシャ哲学の対話篇のごとき深さ。出版年は1993年とかなり古い本ではあるが未だに読む価値を感じる本だった。といっても私はクラブ・ミュージックに対してほとんど門外漢と言っても良い。それだけにテクノについて語られた時に、ゴッド・ファーザー的な存在としてカールハインツ・シュトックハウゼンや、クラフトワークが置かれるのに違和感を感じていた。シュトックハウゼンもクラフトワークも「テクノ」として紹介されて聴いた音楽とまるで違ったものだったから。本書はこうした疑問にも応えてくれるものだし、また、テクノとテクノ・ポップの距離についても教えてくれる。そもそも、テクノという言葉が広く流通する以前からリアルタイムでこの音楽を聴いてきた２人の語りに魅力がある。テクノ史もやや複雑で、電子音楽の流れを組むものや、パンクやニューウェーヴといったムーヴメントのなかから生まれたもの、あるいはデトロイトのように特殊な社会状況から生まれたものもある。こうした複数の流れの見通しが立つのはリスナーとしてありがたい。それに今日ではYoutubeという《サブテクスト》がある。『テクノボン』を片手に検索をかけていくと、どんどん世界が広がっていくのが楽しかった。なかでも衝撃的だったのはDAF。リエゾン・ダンジュルースが大好きな私であるから、これがハマるのは当然な気もするけれど、今すぐ中古盤屋とかに駆け込みたくなる衝動に駆られる音。私の耳は、最近の音楽にはまったくハマれない可哀想な耳になってしまったようなので、こうした方面に新たなステップを踏み出して行きたくなる。あと、カール・クレイグって名前だけは聞いたことあったけど、超カッコ良い～、と思った。学生時代、ニューウェーヴ大好きなヤツは周りにいたけれど、こういうのを聴いている人はいなかった。そういう友人と出会ってたら、今とは随分聴いている音楽が違っただろうなぁ、というほどに、カール・クレイグの音は自分のツ

土井善晴『おいしいもののまわり』

おいしいもののまわり posted with amazlet at 16.02.28 土井善晴グラフィック社売り上げランキング: 8,222 Amazon.co.jpで詳細を見る NHKの料理番組でお馴染みの料理研究家、土井善晴による随筆を読む。調理方法や食材だけでなく食器や料理道具など、日本人の食全般について綴ったものなのだが、素晴らしい本だった。食を通じて、生活や社会への反省を促すような内容である。テレビでのあの物腰おだやかで、優しい土井先生の雰囲気とは違った、厳しいことも書かれている。土井先生が料理において感覚や感性を重要視していることが特に印象的だ。例えば調理法にしても今や様々なレシピがインターネットや本を通じて簡単に手に入り、文字化・情報化・数値化・標準化されている。それらの情報に従えば、そこそこの料理ができあがる。それはとても便利な世の中ではあるけれど、その情報に従うだけでいれば（自分で見たり、聞いたり、感じたりしなくなってしまうから）感覚が鈍ってしまうことに注意しなさい、と土井先生は書いている。これは尹雄大さんの著作『体の知性を取り戻す』の内容と重なる部分があると思った。本書における、日本の伝統が忘れらさられようとしているという危惧と、日本の伝統は素晴らしいという賛辞について、わたしは一概には賛成できない部分があるけれど（ここで取り上げられている「日本人の伝統」は、日本人が単一の民族によって成り立っている、という幻想に寄りかかっている）多くの人に読んでほしい一冊だ。とにかく至言が満載なのだ。個人的なハイライトは「おひつご飯のおいしさ考」という章。ここでは、なぜ電子ジャーには保温機能がついているのか、を問うなかで日本人が持っている「炊き立て神話」を批判的に捉え「そろそろご飯が温かければ良いという思い込みは、やめても良いのではないかと思っている」という提案がされている。これを読んでわたしは電撃に打たれたかのような気分になった。たしかに冷めていても美味しいご飯はある。電子ジャーのなかで保温されているご飯の自明性に疑問を投げかけることは、食をめぐる哲学的な問いのように思える。

2011年7月17日に開催されるクラブイベント「現代音楽講習会　今夜はまるごとシュトックハウゼン」のフライヤーができました

フライヤーはナナタさんに依頼しました。来月、都内の現代音楽関連のイベントで配ったりすると思います。もらってあげてください。イベント詳細「夜の現代音楽講習会　今夜はまるごとシュトックハウゼン」

石版！

このブログを検索