Wiki (Printed as manuscript)

先輩のありがたい話

(株)永和システムマネジメントサービスプロバイディング事業部

伊藤浩一2011.07.28(Thu)

Wiki

本編は発表者が Wiki について考えていることや学んだこと、Wiki から学んだことを主観で語ります。問題提起に対する答えを示す話ではなく、まだ発表者の中で結論が出ていないことも話の流れで出てきますよ。

対象者•@potato_digger•@akiinyo•@shimosuk

•@kunitoo

お品書き•Wikiエンジン

•コラボレーションツール•Wiki 記法と文書構造

•WikiName と URL

•Is Wiki Agile?



•WikiName と URL

•Is Wiki Agile?

Webの世界

Plain-old WebHyperText

HyperLink

HyperText

HyperText

HyperText

HyperLink

Hyper Link

http://upload.wikimedia.org/wikipedia/commons/4/45/MontreGousset001.jpg

Hyper Text で時間を越えて、Hyper Link で空間を越える



Hyper Text はWeb のためのモノという課題

“そこで Wiki エンジンですよ”

Wiki記法を使って、Webブラウザ向きHTMLを、人間向けプレーンテキストで編集

Wiki記法とWikiエンジン•Plain Text で記述•Wiki エンジンによる様々な表記

•Wiki 記法のテキストを HTML にコンパイル

•Plain Text から Hyper Textへ

様々なWikiエンジン•MediaWiki

•Hiki•Trac•Redmine

•qwik

今回取り扱うもの•MediaWiki

•Hiki•Trac•Redmine

•qwik

情報を伝える•ほかの人、のちの自分に向けての文章を簡潔に書く

•プログラムと同じで分かり易く•“伝える事柄と伝える方法は車の両輪だと考えること” と達人プログラマーにもあるよ

情報の共有•さまざまな情報共有ツールの側面からqwikの使い方をもう一度検証してみよう

•一つのエディターを熟知すること (達人プログラマー)



•WikiName と URL

•Is Wiki Agile?

有名な道具Wiki

BlogMailIRC

有名な道具Wiki

BlogMailIRC日付発信アドレス追跡

扱う情報Wiki

BlogMailIRC時間依存

Timelessアドレス依存

情報の流通Wiki

BlogMailIRCpush型 pull型

qwikの領域Wiki

BlogMailIRCpush型 pull型

Mailing List

qwik補完Wiki

BlogMailIRC時々の情報発信まとめ参照

Mailing List

•メーリングリストで時々の情報の発信をする

•Wikiでまとめ情報を参照できるようにする

qwik補完

情報の整理過程

時間経過

発散収束

発散と収束•メーリングリストは議論向き•Wikiはまとめ向き

•メーリングリストで議論した内容をまとめて Wiki に書く

qwik

Mailing List

発散収束

Wiki

弊社qwikのページ構成

ドキュメントモード

スレッドモード

注: 同構成サンプルのコンテンツをAsakusa.rb より拝借して差替え

まとめ

議論

Wikiモードとして注: 同構成サンプルのコンテンツをAsakusa.rb より拝借して差替え

弊社qwikの場合•ファーストポストの多様性•割れたビル窓と更新頻度•ML投稿記事はスレッドモード

•整理した内容はページの先頭に•参加者が量を質に転化させる

私の隠し球•ノートの導入検討•カテゴリの導入検討

Wikipediaのノート

ここ



ノート:WikiName

ここ

Wikipediaのカテゴリ

Wikipediaのカテゴリ

Category:WikiName



•WikiName と URL

•Is Wiki Agile?

qwikでの読み書き•編集は常に Human-readable なプレーンテキスト (文書構造重要)

•メールではプレーンテキストで読む•qwikWebでは HTML で読む

qwikは文書構造を意識した文章を書くためのギブスになる

基本要素 (私家版)•タイトル•パラグラフ•見出し•箇条書き

タイトル•そのページは何について書かれているのか

•Wiki における WikiName

•書籍でいうタイトル

パラグラフ•文章の単位•Wiki ではテキスト

•書籍でいうテキスト

見出し•HTML における <H1> <H2>

•4段以上の見出しは負け•テキストが何なのかを表すもので書籍では目次にも出てくるサマリ

箇条書き•HTML での <UL><LI> や <OL>

•それは本当に箇条か？•2段以上の箇条書きは疑え

文書構造の実例

おススメのWeb文書

わかりやすい技術文章の書き方http://oalp.org/doc/writing/

HTMLとCSS•Wiki 記法で文書構造を表現する

•Webブラウザでの見た目はCSSで行う



•WikiName と URL

•Is Wiki Agile?

Plain-old WebHyperText

HyperLink

HyperText

HyperText

HyperText

HyperLink

Hyper Link

記事へのポインタ

記事WikiName

記事

記事記事WikiName

WikiName

WikiName•そのページは何なのか？•Wiki でフラットに一意なもの

•一等地、二等地、三等地...•CamelCase の慣習

WikiNameはURLの一部

URL•Uniform Resource Locator

•URN, URL, URI•What が Where にある？

•Permalink

Wikiサイトでたったひとつの名前

WikiNameは正しいか間違っているかよりも、分かり易いか分かりづらいか

名付けへの気配り

名前重要



•WikiName と URL

•Is Wiki Agile?

Is Wiki Agile?•Wiki はフレキシブルな道具

•OS のような自由度•Windows はアジャイルか？

•道具としての俊敏性•WikiWiki というハワイ語

Wiki がではなく Wiki を使いこなすことがアジャイルな素養を持つことに繋がるのではという仮説

道具は思考を規定する

Wikiで人を培う•誰のではなく参加者全員のもの•参加者が編集者•少しずつ、少しずつの積み重ね•間違えているなら直せば良い•小さな決定を積み重ねる

地道

みなさんと一緒に仕事をできる日を楽しみにしてます

Wikiって何？

次回

閲覧者と編集者の“境目のない世界”

源流へ

予習復習研究はこちら

http://eto.com/2006/paper/mobaken2006.pdf

なぜそんなにもWikiは重要なのか

なぜそんなにも (アジャイル開発者にとって) Wikiは重要なのか

http://gihyo.jp/dev/serial/01/agile/000402

パターン、Wiki、XPhttp://www.amazon.co.jp/dp/4774138975江渡浩一郎

江渡浩一郎

角谷信太郎

Technology

Wiki (Printed as manuscript)