その手の平は尻もつかめるさ

ギジュツ的な事をメーンで書く予定です

情報共有システム (Wiki みたいなやつ) に求めること

いま所属している組織で使っている情報共有システムが僕はいまいち好きではなくて，気に食わないところを twitter にガーッと書いたんだけど，さてここで「良い情報共有システムとは」と考えた時にスッと言語化出来なかったので，僕の思う情報共有システムに求めることをここでまとめておくことにする．

エディタが腐ってない

これは本当に重要で，エディタが腐っていると「Wiki を書こう」という気がそもそも起きないし，起きたとしてもエディタがストレスフルだと文章を書き始めてすぐに嫌になってしまうので最低限エディタはまともである必要がある．さもなくば Wiki は廃墟と化す．
WYSIWYG なエディタを利用するのは難しいと思っていて，本当に使いやすい WYSIWYG エディタを作るというのはかなりコストが高い (WYSIWYG エディタはある程度まで完成度が高まっていないと使い物にならない気がする) ので，システム側がマトモなエディタを用意してくれている可能性は高くはない．あと WYSIWYG の場合は見たままが成果物に反映されるから，誰かにとって使いやすいものでも他の誰かにとっては使いにくいという事が起きやすいと思っていて，組織全体にとっての使いやすさを最大化するのが難しい気がする．
そうなってくると，何らかの記法 (Markdown やそうした類のもの) に対応してそれを用いて書くのが良いのかなと思うし，僕はそれで良いんだけど，エンジニア以外の人にとってそれは本当に使いやすいのかな？　という懸念はあって，難しいところだと思う．だからと言って，1つのページについて或る人は WYSIWYG で書いて，また或る人は Markdown で書く，みたいなハイブリッドな方法を採用すると大体カオスな事になって不幸が起きるという印象しかない．しかしこのへんに上手い解決法が提供されると幸せそう．
あとブラウザ内にエディタがあるというのは，エディタがブラウザのキーボードショートカットを奪ったり，或いはブラウザに奪われたりするから難しい気もしていて，そうなると既にある文章を API 経由か何かで送りつけられるのが良いのか，もしくはネイティヴなアプリがあると良いのだろうか？　とか思うけどここらへんは良く分からない．一方でブラウザから編集できないと，資料を見ながら「ここ間違えているからスッと直そう」みたいな感じでカジュアルに編集しようとする意識をサポート出来ないから，ブラウザで編集可能である必要自体はありそう．でも GitHub を使っている時にブラウザから README.md を直接編集したくなる事はあまり無い気がする．文化の違いだろうか？

まあ，ストレス無くブラウザでページを編集できれば問題は無さそう．

ページ内の配置がある程度規約に縛られている

Wiki のページはその人の芸術性とかを反映する必要はあまりないはずなので，ある程度規約で縛られていたほうが良いと思う．
「ページ内のここを見たら必ずこれがある」だとか「時系列はページの上の方が新しくて下に行くほど古い」だとか，そういう基本的なことは全ページで共通していたほうが良くて，それは規約のようなものになっているべきだと思う．そうした規約があることで全てのページで「これが欲しい時はここを見ると良い」という共通の認識ができるので，欲しい情報へのアクセスが高速に行えて良いと思う．

自由に HTML を記述できて，自由な場所に自由に要素を置ける，みたいな機能は Wiki だと地獄を生むと思う．

URL の構造が予想しやすい

これは良い API の設計にも似ているけれど，各ページへの URL があまりに自由だと使いにくいと思う．
例えばプロジェクトのトップページは URL パスの親になっていて，その下にそのプロジェクトの各ページや子プロジェクトのページがぶら下がっていて，子プロジェクトはさらにその構造を持っているみたいな感じが使いやすいと思う．全部がフラットな構造になっていて，ページのタイトルがそのままパーマリンクのパスになっているとかはファンキーだけど使いにくいという感想しか無い．

僕はブラウザの URL 窓にプロジェクト ID を打ち込んで，そこから検索履歴に基いて見たいページを絞り込むという方法で特定のページにアクセスすることが多いので，URL に規則性が無いとそれが出来なくて大変な気持ちになる．

検索可能

説明不要だと思う．21世紀の Wiki は全文検索できないと使いものにならない．
あとは「このプロジェクト内の文書だけ検索」みたいな，検索対象を絞れればあまり不満がないけど，検索オプションが多いと便利そう．

添付ファイルをまとめて管理できる

いま所属している組織では PowerPoint や PDF といった様々なファイルが Wiki にアップロードされ，日夜それらのファイルが更新されていきながら，それを見ながら，というスタイルで仕事が行われているので，添付ファイルを一括で管理できると便利．
例えば「企画.pptx」はプロジェクト内のあのページにあるけれど，「デザインガイド.pdf」はプロジェクト内の別のあっちのページにある，みたいな感じになっていてファイルがガンガン増えてくると，いざ「あのファイルが欲しい」となった時にどこに行けば良いのか分からなくて非常にストレスが溜まる．プロジェクト内の添付ファイルを一覧できる機能があれば，とにかくそこに行ってファイルを GET すれば良いので楽だと思う．

他サービスとの連携がしやすい

ページを更新したりした時に，なぜだかメールを飛ばしたがる Wiki が多いように思うけど，メールで飛ばされてもどうせ見ないし，どうしようもないと思う．それだったらチャットやら他のツールやらに飛ばせる方がどう考えても便利だし，その口があらかじめ用意されていると気持ちが良いと思う．更に自分で拡張も書きやすかったらなお良い．

ここまで書いてから気づいたんだけれど，これはイベントに対応する API がちゃんと提供されていれば良いということになった．

その他

と色々書いたのだけれど，Wiki のようなものはエンジニアだけでなく，あらゆる人が使うし，むしろエンジニアでない人の方が多く使う為，エンジニアが使いやすさを追求してもエンジニアでない人にとっては使いにくくなってしまって，全体的な作業効率は悪くなってしまうかもしれない *1．しかし導入する Wiki システムや BTS システムを選定する人は大体エンジニアが中心になっていて，そうした時にどのようにしてフラットな目線で，かつ明確な判断基準を持って選定すべきなのかというところが気になる．

個人的に，情報共有システムについて特に重視すべき点は「記事の作成・更新にストレスが無いかどうか」と「情報へのアクセスがストレス無くスムーズに行えるかどうか」だと思っている．

とにかく僕はここに列挙したような機能が情報共有ツールに付いていてくれると嬉しい．気づいていないだけで，あるいは忘れているだけで，他にもあった方が良い機能はあるかもしれないので，他の人の意見についても大変興味がある．

あと，最高の情報共有システムがあったら教えて下さい．よろしくお願いします．

追記

マジで重要な奴を忘れていた

*1:エンジニアでもない限り，イベント API を使ってアレやコレやしたい，みたいなことは思わないと思うし……