Posted on

ドキュメント勉強会に参加してきました。

ドキュメント勉強会開催の経緯

技術部の今岡です。

もう少し前のことになってしまって恐縮ですが、ドキュメント勉強会というものに参加してきました。

8月6日(木) 大阪市北区のメビック扇町というところで、場所はCakePHP関西勉強会の会場と同じところです。

そのCakePHP関西勉強会の第二回が、私の技術系勉強会の初体験だったにもかかわらず、今回の勉強会では発表者に名前を連ねることになってしまいました。

CakePHP勉強会の後、人から薦められてアカウントを作っていたTwitterを本格的に利用し始めました。

Twitterでは様々な人が好き勝手なことを雑多に呟き、その呟きに興味があったりして継続的にその呟きを読む為には、呟いている人を「フォローする」という操作を行います。

Twitterの詳しい話は今回の話題ではないですが、そのTwitter上でCakePHP勉強会を主催された新原さんという方をフォローさせて戴きました。

新原さんがTwitter上で勉強会というものについて、とか、ドキュメント勉強会ってどう思う?というような疑問を投げられまして、私を含め数人がそれに反応し、その反応の内容を受けて新原さんはドキュメント勉強会を開催しようと決定されました。

(新原さん自身のブログやWassarという別のサービスなどもありますので、Twitterがすべてではないと思います。念のため。)

勉強会の決定や開催日時の告知にもTwitterが有効に活用されました。

そして、そのTwitterを通じて、私のところに発表の依頼が飛んできたのでした・・・。

 

ドキュメント勉強会ってどんなもの?

業界で使われている技術は沢山あり、日々新しくなったり廃れたりしています。

その技術に関しての勉強会は今までもいろいろと開催されているのですが、その技術を伝達したり技術を使った仕事の依頼、記録などに使われる書類(=ドキュメント)の書式は、業界標準が存在しません。

大手企業だとしっかりした社内基準がありますが、個人や零細のソフトハウスでは基準はなく、ドキュメントの存在さえ怪しいのが現状だと思います。

ですので、必要という意識さえないという人から、書こうにも書き方が判らない人、常にドキュメント作成を専門にやりまくっているという人まで同じ業界でもいろんな人がいることと思います。

今回は、ドキュメント作成に興味があったり、なんらかの不自由感困った感がある人達で集まって、それぞれがどんな風にドキュメントを作っているのか、何に困っているのかを話し合ってみましょう!という、チャレンジっぽい勉強会です。

主催者の新原さんから、お題が出ました。それは

「Poken販売サイト」

Pokenというのは、名刺代わりになるマスコットのようなおもちゃのようなモノです。かわいいです。

世間の一部で愛好されていて、新原さんもお持ちです。

それを販売するサイトの製作にあたり、必要と思われるドキュメントを発表担当者がそれぞれに作って勉強会当日にそれを公開し話のタネにします。

勉強会の運営と発表者の連絡用に、事前にメーリング・リストが開設され、出欠確認・お題の発表・新原さんのサンプルドキュメントの配布・当日の会場到着予定時間のお知らせなどに活用されました。

細かい話ですが、勉強会までの道のりは下記のような感じです。

7月7日 ドキュメント勉強会の開催決定

7月15日 今岡のところに発表の依頼がくる

7月下旬 サンプルドキュメントの配布

8月6日 勉強会の開催

 

勉強会の実際

さて、では実際の勉強会とはどんな感じだったのでしょうか?

すでに参加された皆さんが自身のブログなどにいろいろ書いておられますが、とっても面白く為になる内容でした。

いや、本当。

事前に打ち合わせしてないことが信じられないくらい、各発表者の製作意図や方法がバラバラで、結果的に非常にバラエティに富んだ発表内容となりました。

私は自身の日常業務そのままに、小さなソフトハウスが下請けでシステムを製造するという前提でいくつかのドキュメントを作りました。内容としては下記になります。

・メニューフロー

・データベース設計書

・フォルダ構成

・スケジュール

・その他前提条件などのメモ

 

ドキュメントを書くにあたり使用したのはExcelです。

特に笑いどころのない生真面目なものを作成してしまいました。

内容に興味のある方はご一報ください。

発表で使用したドキュメント類はどれでもお送りさせて戴きます。

ダウンロードの仕掛けが出来てなくてすいません・・・。

 

お題である通販サイトの製作には、製造部隊のみならずプロデューサに当たる方やデザイン担当の方などいろいろな人が関わることになります。もちろん、依頼主である顧客もいますし、サイトを利用しPokenを購入するお客様もおられます。

誰の立場でドキュメントを書くかで、書き方も内容も全然違ったものになります。

私は掴みの新原さんの後、二番目の発表でしたが、その後にはWEBプロデューサの方、はたまたドキュメントを普段まったく書かないという方の発表が続き、途中Poken販売サイトというお題にまったく触れない果敢な発表もあり、聞きなれない強力なドキュメント製造ツールのお話、最後に大手さんだ!!と感動の超きっちりのドキュメントが公開されました。

途中で休憩があり、みたらしだんごを戴きました。

ひとりの発表持ち時間は10分が目安とのお話だったのですが、やはり熱くなりがちで時間は押し押しでした。

もっといろんなドキュメントがあるはずですし、もっとしたい質問もあるのでは?と思いました。

第二回の開催が待たれます。

時間の関係で質疑応答はあまりなかったのですが、多くの方が懇親会に参加されましたので、そこで少しは補足が出来たのかなと思います。

私の周辺ではPokenとiPhoneの話題がもっぱらでしたが・・・。

MacにもiPhoneにも馴染みがない私は、隣の席の方に「夏ライオン」のアイコンを見せてもらって感動しました。

 

さて、つらつらとあまり内容はない記事ではありますが、勉強会の雰囲気が伝われば幸いです。

皆さん、勉強会にどんどん参加しましょう!

出来ればがんがん発表しましょう!!

勉強会の敷居は低いです。

業界人と業界の周辺の方、ウェルカムです。

と、言うようなことを主催者の新原さんがおっしゃってました。・・・と、思います・・・。