ドキュメント勉強会に参加してきました。 – 大阪のシステム開発・WEBシステム開発会社技術担当スタッフの覚書き、子だぬきの技術習得ノート
ドキュメント勉強会開催の経緯 技術部の今岡です。 もう少し前のことになってしまって恐縮ですが、ドキュメント勉強会というものに参加してきました。 8月6日（木） 大阪市北区のメビック扇町というところで、場所はCakePHP関西勉強会の会場と同じところです。 そのCakePHP関西勉強会の第二回が、私の技術系勉強会の初体験だったにもかかわらず、今回の勉強会では発表者に名前を連ねることになってしまいました。 CakePHP勉強会の後、人から薦められてアカウントを作っていたTwitterを本格的に利用し始めました。 Twitterでは様々な人が好き勝手なことを雑多に呟き、その呟きに興味があったりして継続的にその呟きを読む為には、呟いている人を「フォローする」という操作を行います。 Twitterの詳しい話は今回の話題ではないですが、そのTwitter上でCakePHP勉強会を主催された新原さんとい
活動日記 ドキュメント勉強会に参加してきました
以前から見ていた、Shin1x1さんのShin x blogでドキュメント勉強会開催を知り、興味があったので参加してきました。 私のドキュメントのイメージ まだ、駆け出しのエンジニアだったころ、ドキュメントに対して持っていたイメージは、ひどいものでした。意味がない、信用できない、何のために書いているんだろう・・・etc. あれから色々と経験を積んで、ドキュメントに対して一つ確実に言える事は、「読み手」があってのドキュメントだという事です。 読み手がどのような状況で利用するか、自分の頭で理解せずに、作り手の自己満足に終わったドキュメントほどヒドイものはありません。 私も過去に、作り手の自己満足としか思えないドキュメントを作っていた時期があります。そのような失敗から、「読み手」があってのドキュメントだという事を強く意識するようになりました。 そのような意識があれば、色々な失敗を防ぐ事ができると
ドキュメント作成に参考になる公開ドキュメント集
Webシステムにてドキュメントを作る際に参考になる公開されているドキュメントを集めてみました。 見た限りはどれも無償で利用可能なようですが、実際に利用される際は規約等をご確認下さい。 発注者ビューガイドライン http://sec.ipa.go.jp/reports/20080710.html 形式：[PDF] IPAが公開しているドキュメント作成ガイドラインです。 発注者とSIerの間で意思疎通を図ることを目的としているので、内容も詳細でかつ分かりやすいです。分量がかなり多いのですが、JavaでおなじみのPet Storeを題材に具体的なドキュメントが載っているので、ざっと見てみるだけでも参考になると思います。 ただ小規模案件だと、このガイドラインどおりに全てのドキュメントを揃えるのはムリがあると思うので、使えそうな部分だけ上手く利用するのが良いでしょう。 関連書籍も出ているようなので、
ドキュメント勉強会に参加しました - 忍び歩く男 - SLYWALKER
8月6日に開催されました、ドキュメント勉強会に参加しました。 今回は、おやつ係&懇親会幹事&発表といった形で関わらせていただきました。 さて、自分自身ドキュメント経験値ゼロという状態の中 気づいたことを何点か ドキュメントには伝える対象によって内容が変化する 発注者向け 開発者向け などなど 使っているツールはOffice系が多い やはり、会社によってフォーマットが違う しかし、内容には共通したものが多い（当然か> 自分の発表 なんかただのツール紹介になってしまいました^^; redmineにすべてのドキュメントをまとめていきたかったんですが、力及ばす。 もっと勉強が必要ですね… 反省点 おやつに出したみたらし団子は、持つところまでみたらしに浸かっていて、阿鼻叫喚だった。 懇親会 ちょうど悩んでいた新人教育などの話ができたことが大きかった。 内容とは関係ないですが eventsのときは、参
ドキュメント勉強会に参加しました
前々からクライアントからこんな話を聞いていました。 会社の担当者によってドキュメント（の質）が違う他社のドキュメントに比べてレベルが低い また、僕自身最近では仕様書 / 要件定義のドキュメントを作成する時間や全体統括のための資料作成などかなり割合を占めるようになりました。 ん～、他社ってどんなの書いてるの？ 旋盤工から転職した僕には、どの程度のレベルで着地すべきなのかがまったくわからない。 ということで、Twitterが縁でshin1x1さん主催のドキュメント勉強会に参加して来ました。 参加してみてやっぱり実感したのは、みんな難しく思っているということ。 うちの会社の場合は、仕様作成から納品まで一人で担当することが非常に多く、やはり脳内ドキュメントを使ってしまう。 でも人に振ったり、引き継ぐためにはやはり具体化が必要だなと思います。 今回はとなりのドキュメントということで、ひとつの題材(要
ドキュメント勉強会がアツく終了しました
ドキュメント勉強会が無事に終了しました。 参加された皆さんお疲れ様でした。 いつもの技術系勉強会とはテーマが異なるうえ、「となりのドキュメント」のようなこれまでやったことの無い企画もあったので、始まる前は正直少し不安がありました。 しかしそんな不安が吹き飛ぶほどの盛り上がりとなり、ひとまず胸をなで下ろしています。 一参加者としては、色々なドキュメントと考え方を一度に見聞きできたのはとても面白かったです。（自画自賛っぽいですが:-D） では以下つらつらと。 ドキュメントって？ shin1x1 ドキュメントに対する考えをぶちまけました:-D ドキュメントは只の技術なんで、難しく考えない。 これに気づいてからは自分はドキュメント書くのが少し楽になりました。 ご意見お待ちしていますm(_ _)m となりのドキュメント 「Poken販売サイト」をテーマに7人がドキュメントを作成して、発表するという企
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
国产高清片-草蜢社区在线观看免费视频_国产高清片-草蜢社区在线观看免费视频
ドキュメント勉強会に参加してきた - yabekenの日記
http://studybookmark.net/studies/view/4a805653-71c0-457b-a84d-7d227c253a82
http://pm.11op.net/2009/08/post-38.php
はてなブログ | 無料ブログを作成しよう