blogPHPでWEB+DBシステムの開発をやっています。4分49秒ドキュメント勉強会が無事に終了しました。参加された皆さんお疲れ様でした。いつもの技術系勉強会とはテーマが異なるうえ、「となりのドキュメント」のようなこれまでやったことの無い企画もあったので、始まる前は正直少し不安がありました。そんな不安が吹き飛ぶほどの盛り上がりとなり、ひとまず胸をなで下ろしています。一参加者としては、色々なドキュメントと考え方を一度に見聞きできたのはとても面白かったです。(自画自賛っぽいですが:-D)では以下つらつらと。ドキュメントって?shin1x1ドキュメントに対する考えをぶちまけました:-Dドキュメントは只の技術なんで、難しく考えない。これに気づいてからは自分はドキュメント書くのが少し楽になりました。_)mとなりのドキュメント「Poken販売サイト」をテーマに7人がドキュメントを作成して、発表するという企画です。申し合わせたわけではないのですが、どの発表もバラエティに富んでいてとても面白い内容となりました。shin1x1企画の説明とサンプル設計書を。似たサイトを参考にする派shinoiさんドキュメント書きがお好きなだけあって、丁寧で綺麗なドキュメント。ExcelでDB設計書は王道ですね。プログラマには嬉しいドキュメントでした:-D社外にも十二分に出せるドキュメントだと思います。loungepさんTwitterアイコンでお馴染み:-D実地で培われたドキュメントの説明から営業ノウハウまで。読む人を考えた内容にする、というのはとても納得しました。費用面や手続きを意識するのは、お客さんと対峙するなら必ず必要ですね。お団子タイムまっちゃさんメソッドで休憩時間に甘味を:-D今回はslywalkerさん仕込みのみたらし団子です。冒頭の写真はこれです:-Dほんのり温かくて旨かった-。msngさんコミュニケーションツールとしてのドキュメント。Poken販売サイト全く関係無い:-Dでも大事なドキュメントの話満載。(過去2回作成分は宝探しの旅に。)slywalkerさんRedmineでドキュメントRedmineを知っている人が大多数。試行錯誤の過程が:-D必要性が出てこないと中々真剣に書けないですね。whosaysniさんreStructuredTextで書くドキュメント。plainテキストでドキュメントが書ける。生成したドキュメントはPDFで、レイアウトはWordで書いたっぽい。これがテキストが書けるのはスゴイ!ASCIIアートは辛そうなので、ここは画像の方が楽かも。plainテキストだから、ソースを一緒にリポジトリに入れとけば、diffもカンタンに取れるし、vimで書けるのも嬉しい。勉強になった人も多いかと。今回もサービス満点な内容でした。懇親会slywalkerさんの仕切りで、沖縄料理屋さんで。E」を教えて貰いました。上海がアツい次回(があれば)発表頂ける方多数!勉強会ではインスピレーションを持って帰る各所で盛り上がっている様子だったので、気兼ねなく奥で騒いでました:-D横串の面白さドキュメント勉強会ということで、一つの技術ではなく、色々な分野の方が参加されていたのが印象的でした。今回は発表のお題がWeb系だったのですが、次回がもしあれば、違う形(業務系とか、制御系とか、ゲーム系とか、もしくはお題の範囲を狭めるとか)を模索して、他分野の方にも発表頂ければと思います。いつもながらバタバタしましたが、参加頂いた皆さん本当にありがとうございました。「ドキュメント勉強会」に参加ドキュメント勉強会に参加してきました。(Close):2(c_c)血亜貴。