2024/06/12 16:16 結論を追記 2024/06/12 20:29 より記事の内容を分かりやすく理解頂くため、タイトルを「PRDやDesign Docを書かなくなった」から変更 2024/06/13 20:39 結論にフロー情報・ストック情報に関する意見を追記 結論 この記事では、「様々な観点を考慮して網羅的にドキュメントを書いて、それを関係者にレビューしてもらう」のではなく、関係者と同期的に対話しながら、観点や選択肢やそのトレードオフを洗い出すことで、少ない手数でより良い答えが見つけられると主張する。 ただし、対話のために必要なドキュメントは事前に書いておくべきだし、対話した結果はドキュメントに残すことが望ましい。そして、そのドキュメントのフォーマットはPRDやDesign Doc以外でも良い。例えば、ADRはアーキテクチャに関する議論の過程と結果を述べる上で必要十分なフォー

何か決定した事実は実装や規則の形で残っているものの、決定までの経緯をチームメンバーが覚えていない――。 この記事では、そうした組織が記憶喪失になることにどう対処していけばよいか、NTT Comの技術顧問である吉羽龍太郎 (@ryuzee) さんにふらっと相談してみたら一瞬で突破口が見つかった＆話に奥行きが出た話を共有します。 目次 目次 軽く自己紹介 事の発端 ryuzeeさんの油セール 実際に聞いてみた 新たなる概念：ADR ADRの実践：その1 何を書くか ADRの実践：その2 どこに書くか ADRの実践：その3 どう書くか 相談を受けて試しに書いてみたADR まとめ 軽く自己紹介 イノベーションセンターの小林 (@ppyv) です。 開発・検証用PCの開発に一段落つけた後、社会人学生としてたっぷり2年間学習を積んでいました。 いまはイノベーションセンターで働く社員のみなさんに、よりよ

FiNCのエンジニアの人数も50人を超え、チームを横断した情報共有の機運が高まっています。 もともと社内には情報共有ツールとしてConfluenceやGitHub Wikiなどがありましたが、前者はMarkdownなどのエンジニアがドキュメントを書きやすい機能が不足しており、後者は情報の検索性に難がありました。 エンジニアのコミュニケーションを活性化させるため、カジュアルに記事を投稿できて誰でも見ることができる、新しい情報共有ツールを導入をすることにしました。 今回は候補として検討した際に、以下の要件を満たしていた情報共有ツールを紹介します。 Markdownを使ってプレーンテキストで記述できる記事の更新履歴のdiffを見ることができるフィードで記事の一覧を見ることができるわかりやすい検索機能コメント欄でのやりとりができるWebhook(チャットツール連携)UML記法やスライドの埋め込みの

社内の事業部・プロジェクトを跨いで、社員間で技術やノウハウの共有をもっともっと盛んにしたいーそんな社員の声から生まれ、社内で運用中のツールをこの度 OSS にして公開しました。 公開先 GitHub 上に公開しています。 atware/sharedocs README にデモサイトや Heroku ボタンを記載していますので、すぐに試すこともできます。 Sharedocs Markdown で記事が投稿でき、コメントや Like やストックができる、言ってしまうとどこかで聞いたことがある某有名サービスのような情報共有ツールです。 投稿画面 絵文字も入力できますし、さらにはシーケンス図やフローチャートも Markdown で描けます。 レスポンシブにしてあるのでスマホやタブレットでも使えます。 つくるに至った背景など 背景 弊社には以前から、 他のプロジェクトでどんな技術が使われているのかよ

社内研修の準備でストレングスファインダーというのを受けてみた結果「適応性・最上志向・戦略性・収集心・着想」となったtanakaです。 社内の情報共有ツールとしてGitLabを使っている話を紹介します。 社内での技術情報共有って難しいですよね。それ自体で会社の売上や自分の給料が増えるわけではありませんし、でもやったほうがいいと大体の人は思っているはずです。 シーブレインでは入社した当時は社内サーバにMTOSを用意して情報共有ブログとして使っていました。あまり使われなくなっていまから3年前に社外サーバにWordPressサイトを用意して情報共有ツールとして使うようになりました。14ヶ月で450記事、月平均32記事とそこそこ使われていましたが、情報共有ツールとして以下のような問題を抱えていました 記事はMarkdownで書けるようプラグインをインストールしていたが、コメントはMarkdownで書

ノハナの中の様子を時に真面目に時にゆるゆるとお伝えします こんにちは、ノハナの原田です。 サーバーエンジニアです。 最近、社内ナレッジ共有のためにesaというWebサービスを導入しました。 社内の活性化に寄与しているのでここで紹介します。 導入のきっかけと選定 ノハナではナレッジの共有に、プロジェクト管理ツールに付随しているWikiを使っていましたが、以下のように使いづらい点がありました。 記事を書く際にリアルタイムプレビューがない 記事を書く際に画像をドラッグ貼り付けできない 記事URLに記事タイトルを含んでいて、タイトル変えるとリンク切れになる 更新通知がメールだけでWebHook通知ができない さらに、この1年でメンバーが20人から30人の規模に膨らんでおり、既存ツールの運用見直しや移行の機運が高まってきた中で、有志メンバーによって移行の検討が始まりました。 同様のサービスがたくさん

http://peatix.com/event/121751/ での発表資料です

Slackで簡単に「日報」ならぬ「分報」をチームで実現する3ステップ 〜Problemが10分で解決するチャットを作ろう〜 開発プロジェクトを進めていくと、チームは様々な課題に直面する。こうした課題は、週次のミーティングや日報で共有して解決していくことが多い。 課題は大小様々だが、特に数時間で解決できるような小さな課題をいかにリアルタイムで解決していくかで、チームのスピード感が大きく変わってくる。 僕のチームでは、リアルタイムの課題解決の為に、社内チャットSlackを社内Twitterのようにする邪道な使い方「分報」という取り組みを実践している。 > 日報の弱点日報の弱点 日報は一日の業務の報告書で、一般的に「進捗状況」「体験」「学習」「課題」が記載される。これらをチームで共有することで暗黙知を減らし、個人とチームを成長されることが目的だ。報告方法はチームによって様々だが、メールをはじめ、

こんにちは、ライターの岡田大です。 お待たせしました。特別編「トップエンジニアたちの夜」のPart4をお届けします。 ※Part1～3未読の方＆内容を忘れてしまった方は、Part1・Part2・Part3を一読してからお楽しみください！ リモートワークを成功させるために必要なモノとコトについては前回お伝えした通り。ルールとマナーなくして成り立たないことは言うまでもなく、そのことをメンバー（とくに新人）に徹底させるために、リモートワークを積極的に導入している伊藤氏は、ガイドラインをドキュメント化することにより意識の共有を図っているという。その際に活用しているのが、技術情報共有サービスQiita:Teamである。堀木氏の口から「Qiita:Team」という言葉が発せられるやいなや、参加メンバー一同がこれに食いつき、座談会はチーム内における情報共有に関する話題で持ち切りになっていった……。なお、

ども。はじめまして。岸です。 日報・議事録・ソースコード・気になったニュースやアプリ...などなど。チーム内外での情報共有って、重要なんですがまぁ面倒くさいですよね。 単に共有するだけならメールやチャット、ファイル共有サービスで十分なんですが、ぶっちゃけ「ただ単純に共有だけしてもあんま意味ない」んですよ実際...。 ただ共有しても意味が無い。情報を活用するために必要なステップとは？ 前述の通り、情報ってただ単純に「共有すれば終わり」ではなくなんかしらに活かしてこそようやく意味を持ってくるもの。 なので、そのために必要なプロセスとしては... とりあえず全ての情報を蓄積する バラバラな情報を再構成してまとめる それぞれの情報を基に議論や考察を行う 考察の結果を踏まえて「抽象化」する んでそれを「体系化」してすぐに取り出せるようする みたいな項目がどうしても必要になってきます。 溜まった情報を

Qiita/Qiita:Team Meetup #8 LT slide.

社内の情報共有で困っている会社は多いみたいですね。でも実は、nanapiという会社ではそこまで困っていなかったりします。元々文章を扱う会社というのもありますし、ドキュメント化して共有しようという風土が染み付いているからだと思います。 そういったこともあり最近登壇するときなど、社内の情報発信などについて話す機会が増えました。弊社では社内における情報共有のツールとして、Qiita:Teamを使用しています。 生産性を向上させる情報共有ツール - キータチーム（Qiita Team） 全員がMarkdownで文章を書く 実際にnanapiではQiita:Teamを導入してから、現在ではエンジニアだけでなくアルバイトも含めた全社員がここに様々なドキュメントを投稿しています。 Qiita:TeamはMarkdownで書けるようになっています。つまり、社内のメンバーは全員がMarkdownで文章を書く

情報共有すれば必ず何か良いことが起きるというのは間違いの続きになるが、他にもよくある間違いがある。それは「社員は皆、他の人に共有すれば役に立つ有益な情報を持っている」という誤解だ。実はこれを信じている人は多く、その誤解からとりあえず社内SNSさえ始めればなんとかなると思い込んでいる人は多い、 たしかに社員はアイデアや情報を持っている。しかしそれが役に立つかどうかは別の話だ。例えば会社の営業力を高めるために社外人脈情報が重要だということがわかったとする。さてこの重要な社外人脈は誰が持っているのだろうか？この場合、新入社員や管理部門の社員がそれを持っている可能性は低いだろう。また特定業務プロセスを改善するアイデアを探すときに、その特定業務を知らない人がアイデアを出せることも稀だ。 そう一つ前のエントリーと同じで、はじめに情報共有する目的があり次にそれに役に立つ情報が定義されるとその情報を持って

新野さんがこっちのブログで紹介した「コラボレーションに関する5つの迷信、ガートナーが斬る」という記事が面白い。 その中の特に「迷信2：コラボレーションは本質的によいことである。」には特に感じ入る。仕事柄組織内のコラボレーションや情報共有を進めたいという相談を良く受けるが、そのうちのだいたい半分は「とりあえず情報共有したら何か良いことが起きるだろう」という安易なもので、さらにそのうちの多くがどんな情報を共有するのか考えていない（あるいはわからない）というような状況だ。こういう状況でとりあえず社内Twitterを始めてみようなんて事が非常に多い。 そしてたいがいそういった情報共有の試みは大抵にして数ヶ月で飽きられ何も効果を出さずに見捨てられていく。目的のないコラボレーションは何も生まないどころか、余計な仕事を増やすだけで害だとすら思う。 情報共有を進めたいのであればいきなり始めたりツールに飛び

印刷する メールで送る テキスト HTML 電子書籍 PDF ダウンロード テキスト 電子書籍 PDF クリップした記事をMyページから読むことができます 知識やノウハウを見えるカタチで蓄積 人材の流動化が勢いを増す中、日々の業務の中で生まれてくる「気づき」や「ノウハウ」をいかにカタチにし、資産として残すかは、今日の企業にとって重要な課題だ。今、そうした「集合知」を蓄積し、更新し、さらに見つけ出すためのツールとして注目を集めているのが「Wiki」というツールだ。 Wikiはウェブサイトのひとつの形態だが、誰でも簡単にコンテンツを追加、削除し、編集できることが特徴となっている。例えばこの記事がWiki上に掲載されていれば、読者であるあなた自身が情報を追加したり、修正したりできることになる。 誰もが自由に編集できたら混乱が生じると心配する人もいるかもしれない。しかし、実践してみるとちゃんとした

最近社内でナレッジマネジメントの展開を行いたいからと呼ばれて相談を受けることがまた増えてきた。で、相談に答える形でひとしきり話を聞かれて最後の段になって、実は不景気でIT投資にまわせるお金は無いという話を切り出されることも多い。 でお金がないとナレッジマネジメントができないかというとそんなことは無い。以前にもローテクナレッジマネジメントをいくつか紹介してきたようにアイデア次第でどうにでもなる。 特に最近私がお薦めしているのは、社内コンシェルジュの設置・運用だ。これは社内に「なんでも相談センター」を設置して、営業なり開発なり現場の困っている事を解決する仕組み。社員1名と電話とパソコンだけ用意すれば直ぐに始められる。 営業が提案書を作るときに「こんな資料が欲しいんだけど」「この会社に営業に行きたいけど知り合いいない？」と悩んだら「なんでも相談センター」に電話する。開発が「こんなことに詳しい人は

昨日はITRさんの「IT Trend 2010 特別コンファレンス」にちょっとだけ顔を出してきた。業務が忙しくて舘野さんの「立て直しが迫られる日本企業のIT投資」のセッションだけしか聞けなかったのだが、その中でちょっと私にとっては痛い話があった。 舘野さんは「国内IT投資動向調査報告書2010」の結果を元にプレゼンされたのだが、そのなかに以下のチャートがあった。(図は日経IT Plusの記事より） この図で「マスター・データの統合」「情報・ナレッジの共有/再利用環境の整備」「全社的なコンテンツ管理インフラの統合」の３つ（いずれも私の担当千分野である）が今年も上位にランクインしたことを説明した際に、 実はこの３つ「マスター・データの統合」「情報・ナレッジの共有/再利用環境の整備」「全社的なコンテンツ管理インフラの統合」は、毎年重要度で上位に上がって数年以内に実施したいと言う結果になる割には、