「情報」を「書く」ということ(仮) #RedmineJapan

REDMINE JAPAN vol.2 「情報」を「書く」ということ(仮) #RedmineJapan
「情報」を
「情報」を
「書く」
「書く」
ということ
ということ(
(仮
仮)
)
REDMINE JAPAN vol.2

0.自己紹介
0.自己紹介

三浦一仁(みうらかずひと)
事故紹介？
• 通称:みうみう
• Twitter:@kazuhito_m
• Github:kazuhito-m
• フリーランスのプログラマー
– 最近はC#でWindowsクライ
アントだったり、Javaで
WebAPI作ったり、インフラ
チームに居たり…
• 好きなもの:自動化,
「継続的ほにゃらら」
– CI/CDとか大好物

三浦一仁(みうらかずひと)
事故紹介？
• 通称:みうみう
• Twitter:@kazuhito_m
• Github:kazuhito-m
• フリーランスのプログラマー
– 最近はC#でWindowsクライ
アントだったり、Javaで
WebAPI作ったり、インフラ
チームに居たり…
• 好きなもの:自動化,
「継続的ほにゃらら」
– CI/CDとか大好物
平凡な
「プログラマー」
です。

拡張自己紹介①
• 「プログラマー」です
– 「CI/CD」「自動化」「リリースプロセス設計」な
んかが得意好きです
• アジャイルプレイヤーとして
「チームビルディング」の真似ごと
程度はやります
– PMやPLロールで仕事はしていません
• 自分の仕事をやりやすくするために「情報の置
き場」や「運用設計」をすることがしばしばあ
ります

今日の発表について
●
個人の経験に基づく「個人の考え・ケース」です
– みうみうは「情報」や「プロジェクト管理」を勉強し
たことはありません
– 「学術に基づくもの」でもなければ「どこかの本や記
事に書いてあったこと」でもありません
●
むしろ「今日の話を言語化している言葉や書籍」
を探しています
– 「そんな”みうみう語”でテキトーな話してっけど、要
するにコレやろ？」みたいな記事・書籍・発表を知っ
てる方、教えてください！
●
なので、おそらくはしばらく(仮)です

今日の発表について
●
個人の経験に基づく「個人の考え・ケース」です
– みうみうは「情報」や「プロジェクト管理」を勉強し
たことはありません
– 「学術に基づくもの」でもなければ「どこかの本や記
事に書いてあったこと」でもありません
●
むしろ「今日の話を言語化している言葉や書籍」
を探しています
– 「そんな”みうみう語”でテキトーな話してっけど、要
するにコレやろ？」みたいな記事・書籍・発表を知っ
てる方、教えてください！
●
なので、おそらくはしばらく(仮)です
あと
Redmine
の話は
(ほぼ)しません。

皆様は、
1.自分ならどう設計する？
2.Redmineは採用する？
3.Redmineをどう使う？
を頭に置いて
お聞きください。

1.情報設計とコミュケーションプラン
1.情報設計(情報整理)
と
コミュニケーション
プラン

1.情報設計とコミュケーションプラン
1.情報設計(情報整理)
と
コミュニケーション
プラン
偉そうでわかりにくいですね…
要は
「どこに、
何書いて、
どう置いとくか」
の話をします。

自分は、
開発プロジェクト開始時、
しばしば
「こんなやりとり」
をしたりします
(しません？)

とあるプロジェクト開始時の風景
Aさん
みうみうさん
開発プロジェクト
始まるねー
そだねー
管理とかする
リーダーっぽい
人の…
なんとなく便利に
使われている
プログラマーの…

Aさん
明日から
プログラマさん
参画してくるけど…
やりとりとか
どうしよ？
チャット(例:Slack)
でも置いてみて、
そこでコミニュケーション
取ってもらい
ましょっかー
コミニュケーションプラン(一部)の定義
みうみうさん

Aさん
プロジェクト運営設計の一部？
「課題管理」
とか、どうしよう…
じゃあ
Redmine
建ててみましょっかー
(申し訳程度の
Redmine要素)
みうみうさん

Aさん
情報設計
プロジェクトルール
とか、
参画者導入記事とか
書いときたいし、
そういう
ポータルみたいなん？
作っときたいねん…
じゃあRedmineの
Wiki使って、
そのトップページを
ポータルに
見たてたら
どうすかねー？
ポータル
新規参画者導入記事
Wiki
みうみうさん

Aさん
情報設計・情報整理
そういえば…
既存の
「要件定義書」とか
「基本設計書」とか、
プログラマさん
見れないと
だめだよねぇ？
ポータル
Wiki
ああ、それはすでに
「社内のNAS」
にあるもんですね?
Wikの導入記事に
Path貼っとき
ましょっか。
NAS(社内ファイルサーバ)
要件定義書基本設計書
みうみうさん

Aさん
ポータル
Wiki
あ、重要なやつ！
「ソース管理」
どうするか、
忘れてた…。
この会社は
GitHubにお金払って
ますよね？
プライベート・リポジトリ
作ってプログラマーを
招待しときましょ
ソース管理
プロジェクト運営設計の一部？
みうみうさん

なにをやってるのか、の話
Aさん
ポータル
Wiki
ソース管理
みうみうさん
これは
「情報の種類と置き場」
と
「人々の”やり取り”の仕方」
を決めています。

みうみうさん
なにをやってるのか、の話
Aさん
ポータル
Wiki
ソース管理
つまりは…
「情報設計」
と
「コミニュケーションプラン
(の一部)」
の定義・設計を
しているのです。

今日は、その
「情報設計のやり方」
と
「その(出来たものの)カタチ」
について話します

2.情報設計のパターンを探ってみる
2.情報設計の
パターンを探ってみる

先程、例として出したこの情報群
ポータル
Wiki
ソース管理
先程、
例に出した
「情報の種類と置き場」
を”自分なり”に
抽象化(一般化？)
してみたいと思います。

俺なりの、分析(ナベアツリスペクト)
ポータル
Wiki
ソース管理
①静的情報 ②動的情報
(タイムライン)
③その他資源
(の情報)
⊕用途特化
ツール群

これが自分の考える「情報」の種類
③その他資源
(の情報)
⊕用途特化
ツール群

これが自分の考える「情報」の種類
③その他資源
(の情報)
⊕用途特化
ツール群
この「三種の情報＋α」が
「プロジェクトの情報」として
「最低で最大」のもの
「３つの道具(置き場)が要る」
と同時に
「最低限以上に増やさない」
のも、
また重要

これだけじゃ
「なんのこっちゃ？」
かもしんない…
「定義」と
「関係性」を
考えてみます。

2-1.情報の種類の「定義」
2-1.情報の種類の
「定義」

情報の種類の「定義」
③その他資源
(の情報)
⊕用途特化
ツール群

②動的情報
③その他資源
(の情報)
⊕用途特化
ツール群
①静的情報の「定義」
①静的情報
●
失われては困る(ライフサイク
ルの長い)情報
●
蓄積し、メンテ(改廃)していく
べき情報
●
「階層」など情報に「構造」を
持つもの
●
「テキスト」や「図」
置き場(道具・ツール)の候補
●
Wiki、CMS
●
ブログツール・サービス
など
置き場(道具・ツール)の代表例
置き場(道具・ツール)の要件
●
「テキスト」や「図」が置ける
●
文字による(全文)検索性
●
検索容易性(すぐ検索できる)

①静的情報
③その他資源
(の情報)
⊕用途特化
ツール群
②動的情報の「定義」
②動的情報
●
チャットツール・サービス
●
メッセンジャーアプリ
●
グループウェア
など
●
「テキスト」や「図」が置ける
●
情報を時系列で追える

②動的情報
①静的情報
⊕用途特化
ツール群
③その他資源(の情報)の「定義」
③その他資源
(の情報)
●
NAS
●
ストレージサーバ・サービス
など
●
(コンピュータ・ファイルシステム
的な)ファイルが置ける
●
比較的大容量なファイルが置ける

③その他資源
(の情報)
②動的情報
①静的情報
⊕用途特化ツール群の「定義」
⊕用途特化
ツール群
ツールの候補
●
ソース管理ツール
●
進捗管理ツール
●
スケジュール管理ツール
など
ツールの要件
●
「情報」は扱うが「実態」はわか
らずツールを介して「見る」よう
なもの
ツールの代表例(カテゴリは雑多)

「すべての情報」のツールの要件
③その他資源
(の情報)
⊕用途特化
ツール群

2-2.情報の種類の「関係性」
2-2.情報の種類の
「関係性」

情報の種類の「関係性」
③その他資源
(の情報)
⊕用途特化
ツール群
相互に参照可
参
照
可
(逆
は
不
可
)
参照可
(逆は不可)
参照可
(逆は不可)
参照可
(逆は不可)
参
照
可
(
逆
は
不
可
)
ただし、
②動的情報、③その他資源、
用途特化ツール群
⊕
の「トップURL」は、
①静的情報のポータル等から
参照される

ちょっと
わかりにくい
ですかね？
もうちょっと
具体的に…

③その他資源(の情報)
情報の種類の「関係性」の”例えば”
①静的情報 ②動的情報(タイムライン)
⊕用途特化ツール群
ポータル
09:30
10:21
13:03
15:11
17:34
階層記事
野良記事
野良記事
議事録
z
z

情報の種類の「関係性」の”例えば”
ポータル
09:30
10:21
13:03
15:11
17:34
階層記事
野良記事
野良記事
議事録
z
z
うん、
わかりやすくしようと
思ったけど、
余計
わかんないすね…
(察してください)

2-3.パターンと捉えて名前をつける
2-3.パターンと捉え、
名前をつけてみる

さっきからずっと置いてあるコレ
③その他資源
(の情報)
⊕用途特化
ツール群
これが、自分の考える
「情報設計のパターン」
です。
そして、このパターンは
「ITか」は問わず、
ヨロズ「プロジェクト」や
「組織」で使える
情報設計だと思ってます。

ちゃうねん、しゃーないねん…
③その他資源
(の情報)
⊕用途特化
ツール群
これを、この発表中では、
「情報設計
パターン(みうみう)」
と…

3.いろんなケースを「…パターン」で考えてみる
3.いろんなケースを
「情報設計
で考えてみる

「パターン」として成り立つのか？
• 先程
”このパターンは「ITか」を問わず、
ヨロズ「プロジェクト」や「組織」で使える
情報設計”
と言いました
• 「本当にそうなのか？」を確認するため、
「自分が情報設計した現場」
はもちろんのこと
「他者(他社？)によって設計されたもの」
「非仕事、非ITの場合」
にも当てはまるかを実例から見てみます

3-1.IT現場の例(現在)
3-1.IT現場の例(現在)

Sample-01
• 今やってる「開発」の仕事
Wiki & Issues
ソース管理

Sample-02
• 一昨々年やってた「開発」の仕事
ソース管理

Sample-03
• 今やってるOSSっぽい個人の「開発」
ソース管理
Wiki & Issues

Sample-04
• 島津製作所(冗談ですよ)
Sample-04

Sample-04
• 最近までやってた「インフラ」の仕事(Ver.1)
Sample-05
ソース管理

Sample-04
Sample-05
ソース管理
めっちゃやりにくい！
●
「本社の意向」というよくわからないもの
で「自由に書く」ことができない
●
「社内LAN」「オンプレ」に縛られる
●
Redmineにも成約が多い
もう「書くとこない」ので、
ソース管理にMarkDownで
ドキュメント書いてた

Sample-04
Sample-06
進捗管理
ソース管理
GCP
Cloud Source Repository

3-2.IT現場の例(過去)
3-2.IT現場の例(過去)

Sample-04
• 前居た会社の「開発」(1プロジェクトかな)
Sample-07
進捗管理
ExcelでWBS
ソース管理

• 最初に就職した会社(の開発)(20年くらい前か)
Sample-08
進捗管理
ExcelでWBS
ソース管理
古のOutlook 古のOutlook
With
Excrl課題管理表
というか
流れの早い
メール

3-3.勉強会・コミュニティの例
3-3.勉強会・
コミュニティの例

Sample-04
• 「インフラ勉強会」というオンライン勉強会
Sample-09
ポータルのみ個々記事
ソース管理
基本ない
…が、一部だけ

3-4.勉強会・コミュニティの例(一過性)
3-4.勉強会・
コミュニティの例
(イベント等
「時間で終わる」
一過性のもの)

Sample-04
• 「インフラ勉強会」の「一周年イベント」
Sample-10
なし
進捗管理

Sample-04
• RedmineJapan Vol.2 運営
Sample-11

3-5.非IT・パーソナルの例
3-5.非IT・
パーソナルの例

• 親族(会議の履歴や決めごと)
Sample-12
「記事」というより
固定ページ作成
編集人が一人だけ
情報設計としては
失敗か？

• 家族(会議の履歴や決めごと)
Sample-13
進捗管理

• みうみう個人の生活(with少しの友達)
Sample-14
進捗管理

色々みていきましたが…
• と、いう感じに「他者(他社？)事例」の事例に
当てはめてみました
• 自身の設計でなくとも、多くの設計が「情報設
計パターン(みうみう)」に当てはまることが多
いのかな？と

言うて、
「上手いこと行く」
んやったら、
なんでもええけどな！

4.この「…パターン」運用の勘所
4.この
「情報設計
運用の勘所

運用の勘所
• 自分が、この考え方で設計して実際に使ってみ
た「これはこうしたほうが上手く行った」の経
験則を話ます

運用の勘所その①
• 情報の「一元化」を頭に置いておく
– 同じ情報は「一つしかない」を「当たり前」の意識
にする
• 「情報の置き場」はできる限り頑張って「定
義」通りにする
– 生まれた時から「記事っぽい」情報は「静的情報」
において「動的情報」にリンク(URL)を流す
– 「動的情報」に「息の長そうな情報」「変わってく
(メンテが必要な)情報」が貼られたら、「静的情
報」に転記して「動的情報」に再度通知
– 「動的情報」に「保存必要なファイル」等が貼られ
たら、「その他資源」に置き直して「静的情報」か
らリンクを貼る

運用の勘所その②
• 各「情報種」の中も「設計」する
– 例えば「静的情報」や「その他資源」の中でも「階
層と意味」を決める、とか
• 「静的情報」にWikiを採用してるなら「記事の階層」設
計
• 「その他資源」にNASを採用してるなら「フォルダ・
ディレクトリ階層」設計
– 例えば「静的情報」と「その他資源」の階層を合わ
せる、とか

運用の勘所その③
• 「運用ルール」は「そのプロジェクト(あるい
は対象の事象・組織)」ごとに決める
– 一辺倒で「すべてのプロジェクトでこのルール適用
だ！」ではなく、個別に最適化する
• 今まで上げた「設計」や「ルール」、また採用
した「道具」は、見直して更新していく
– プログラムでいうところの「リファクタリング」
– 「このほうがええやろ」と思ったら躊躇しない

5.最後に(まとめない)
5.最後に(まとめない)

いかがでしたか？
• 発表をご覧いただき、ありがとうございました
• 今回の発表を聞いて「どう思い」ましたか？
– 「あたりまえやろ」「何を今更…」「説教くせえ」
– 「いや、それは間違ってる！」
– 「大層に言うてるが…それはすでにXXXが過去に通っ
た道だ！」
• それらのフィードバック、ぜーんぶください！
– 最初に言ったように「みうみうの勝手な考え」で「学
術」や「書籍」等で裏付けられたものじゃない
– 明日も「この考え」で仕事や生活していくが…他者(外
界)との「考えのすり合わせ」がしたい
– TwitterでもFacebookでもブログでも、なんかなん
かよろしくおねがいします！

皆様の、
1.自分ならどう設計する？
2.Redmineは採用する？
3.Redmineをどう使う？
の答えは、
どうなったでしょうか。

あれ？
事前に言うてた
内容は？
違うことない？

まーたこのパターンか…
そ
ら
そ
う
よ
！
ご
め
ん
な
さ
い

「情報」を「書く」ということ(仮) #RedmineJapan

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

More from Kazuhito Miura

More from Kazuhito Miura (20)

Recently uploaded

Recently uploaded (9)

「情報」を「書く」ということ(仮) #RedmineJapan