投稿日:2007年10月05日 作成者:yasunaka
CDS – これはCollaborative Documentation Serviceの頭文字をとったものです。以前のブログにも書いたとおり、このCollaborative Documentation Serviceというのは、crossnoteのキー・コンセプトです。
これを一言で説明すると、以下のようになります。
Collaborative Documentation Serviceとは –
『ドキュメントを書き換えてコミットするだけで、対象者に「どこ」が「どう」変わったのかを伝える仕組み』
私が何でこれを思いついたかというと、プロジェクトで次のようなことが良く起こっていたからです。
1.最初のうちはきちんと仕様をドキュメントに書いています。
2.プロジェクトが進むにつれて、様々な仕様変更が発生します。その仕様変更について、メール上でああしよう、こうしようとやり取りします。
3.プロジェクトが忙しくなってくると、上記の仕様変更内容をドキュメントに反映し忘れ始めます。
4.これではイカンということで、ドキュメントを修正してメールで回覧する方式にすると、様々なバージョンのドキュメントが散乱することになり、それはそれでどれが正式の仕様なのかがわからなくなりがちです。またちょっと直しただけで毎回でかいドキュメントを送りつけられ、どこが変わったのかをチェックしなければならない受け取り側もえらい迷惑です。
5.最終的に、ドキュメントは「当初の」考えを示すだけのものになり、実際の仕様とは大きく乖離した状態になる場合があります。こうなってしまってはなかなかドキュメントを修正する気力も出ません。
6.さらに後になって、仕様がどうだったかを調べようとすると、ドキュメントとメールの両方を調べなければわからず、大変な思いをします。
皆さんはどうですか? いつも完璧にこなしているという方もいらっしゃるかもしれませんが、私は恥ずかしながら、上記のような状態になることが多かったです。でもそこでふと考えたのです。そもそもメールとドキュメントの2つのものを同時に書かなければならないことが間違っているのではないかと。
ドキュメントの情報は後で参照するときに体系だてて理解できる構造になっています。一方のメールの情報は順を追って読まないとわかりづらく、また体系付けられてもいません。
では、メールを書くのではなく、ドキュメントを修正したら自動的に差分が通知されるようにしてはどうか? その差分の情報をメールのように皆に通知してはどうだろうか? さらに自分の「考え」を説明するためにコメントなどをいろいろと付けて、そのコメントをやり取りできるようにすれば、もうメールは要らないのではないかと。
これがCDS – Collaborative Documentation Serviceを思い立った原点です。プロジェクトが破綻する最大の要因は、仕様を纏め上げる作業、すなわち上流工程に問題がある場合だと思います。プログラミングの世界ではどんどんシステム的なサポートが充実してきているのに、上流工程部分にはシステマティックなサポートがありませんでした。この仕様をまとめ上げる仕事を少しでもバックアップできるような仕組みとして、このCDSを普及させていきたいと思います。
投稿日:2007年09月28日 作成者:yasunaka
さて、引き続きcrossnoteのお披露目シリーズ、第5弾です。(すみません、そろそろワンパターンですね)
今日はアウトライン機能を使って、ドキュメントを編集するデモをお見せします。

上の図をクリックして、表示されたFlashのStartボタンを押してください。
crossnoteではドキュメントを直接ワープロのように修正することも出来ます。設計書や仕様書などを作る場合、今回デモしたようにドキュメント全体の構成をタイトルを考えることであらあら決めておき、後で中身を書くという使い方が多いと思います。そのような場合にはこのアウトライン機能は非常に強力な助っ人になると思います。
投稿日:2007年09月28日 作成者:yasunaka
今週載せたFlashのデモですが、IEだと見れなかったようです。(FireFoxでしか確認せずに気づきませんでした。すみません)
今は直っていると思います。見れないと思ってあきらめた方、ぜひもう一度トライしてみてください…
投稿日:2007年09月27日 作成者:yasunaka
さて、引き続きcrossnoteのお披露目シリーズ、第4弾です。
今日は大盤振る舞い(?)で、テキストの比較のデモと表の比較のデモの2つをお見せします。いずれも非常に短いデモですので、気軽に見てください。
まずはテキストの比較です。

上の図をクリックして、表示されたFlashのStartボタンを押してください。
テキスト枠が変更されたときの、中身同士の比較の例です。
次は表の比較のデモです。

このように、中身同士の比較を行うこともできます。
次回は、アウトライン機能を使うあたりについて説明したいと思います。
投稿日:2007年09月26日 作成者:yasunaka
さて、引き続きcrossnoteのお披露目シリーズ、第3弾です。
今日はドキュメントの構成比較のデモをお見せします。

上の図をクリックして開いたFlash画面のStartボタンを押してください。
パラグラフが追加されてきた時の、構成比較の例です。crossnoteは通常のワープロとは若干異なり、ドキュメントはパラグラフやテキスト枠、図形枠、表枠などといった「部品」を組み立てて構成します。これらの「部品」がドキュメント上でどのような順序で配置しているかを表現したものが「構成」です。そしてupdateする前とした後でこの構成がどのように変化するかを比較する画面が、この構成比較です。
次回は、テキストの比較画面について説明します。
投稿日:2007年09月25日 作成者:yasunaka
先日に引き続き、crossnoteのお披露目第2弾です。
今日はupdateボタンのデモをお見せします。

上の図をクリックして開いたFlash画面のStartボタンを押してください。
これはupdateボタンを押したときの動きを説明しています。自動的に同期Viewに切り替わり、他の人が変更した箇所が表示されます。また同時に開いているドキュメントも修正されています。
次回は、この先の比較画面について説明します。
投稿日:2007年09月21日 作成者:yasunaka
今日はcrossnoteのスナップショットを、このブログを見ていただいている皆さんにだけ特別に、ちょっとだけ先行公開します。
こんな感じです。

(大きな画面でよく見たい人はこちらをどうぞ)
ま、見た目はワープロみたいなものでしょう。左側にプロジェクトを先頭にしたフォルダーやドキュメント、またそのドキュメントの中身がツリー上になって見えているのは通常のワープロとは違う点かもしれません。
大きな画面で見ないと良くわかりませんが、上のツールバーのところに、保存ボタンの隣の、左から2番目に表示されている矢印のボタンが、Collaborative Documentation Serviceを実現するためのもっとも重要なボタン「updateボタン」です。
また近日中に続きをお見せします。
投稿日:2007年08月31日 作成者:yasunaka
さて、今日もcrossnoteの小さな工夫シリーズ、行きます。今日ご紹介するのはビュー機能です。(Eclipseを知っていると、いろいろと用語が混乱するかもしれません。これはEclipseのViewとは異なります)
crossnoteではWindowsのExploreのようにプロジェクトやドキュメントをツリー状に表示するための「ワークスペース」という画面があります。このワークスペース画面にはビューと呼ぶフィルター機能がついています。
ドキュメントを新規作成する場合には、ドキュメントがどのビューに所属するのかを指定します。このビューとは、例えば以下のようなものです。
「成果物」
「検討資料」
…
ドキュメントを作るにあたっては途中、いろいろな検討資料も必要になります。しかもこのような検討資料は無秩序に増えやすいと思います。そうすると、あるフォルダの中で、どの資料が最終的な結論が書かれた成果物なのかわかりにくくなります。実際、後からプロジェクトに関わった場合とか、あるサブ・プロジェクトの成果を利用して別のサブ・プロジェクトを進めるような場合には、どれがあらかじめ読んでおくべき資料なのかがわからず、後になって大切な資料を読み忘れていた、なんて経験のある人も多いのではないでしょうか?
このビュー機能を用いると同じフォルダー内でも指定したビューのドキュメントだけが表示されるので、例えば外部からの参加者に対しては成果物ビューの中の資料だけ読めばよい、などといった使い方ができます。なおすべてのドキュメントを表示する指定方法もあります。
なおこのビュー定義は、プロジェクト・ポリシーの設定にて、プロジェクト毎に独自の定義を行うことも可能です。
投稿日:2007年08月30日 作成者:yasunaka
さて、crossnoteの小さな工夫シリーズの第5弾です。今日はプロジェクト・キーワードという仕組みをご紹介します。
プロジェクト・キーワードとはプロジェクト毎に定義することができるキーワードです。例えば、
プロジェクト名 「APISプロジェクト」
プロジェクトID 「UPDATEIT-001」
システム名 「apis」
商品名 「crossnote」
のようなキーワードと値を予め登録しておきます。ドキュメントの中で「プロジェクト・キーワード(例えばプロジェクト名)の挿入」を行うと、値(例えば「APISプロジェクト」)に置き換わって表示されます。プロジェクト・キーワードの部分は背景色が水色になっているので、ドキュメントのどの部分がプロジェクト・キーワードになっているかはすぐにわかります。
プロジェクト・キーワードの値は1箇所で管理されるので、プロジェクト・キーワードの値を変更すると、そのプロジェクトのすべてのドキュメントについて、自動的に新しくセットされたキーワードの値に置き換わるようになっています。
同じように、ドキュメント毎にドキュメント・キーワードを定義できるようになっています。ドキュメント・キーワードとは、例えば「ドキュメントID」などのようなものを登録します。
さらに、crossnoteのドキュメントのヘッダーやフッターはプロジェクト・キーワードおよびドキュメント・キーワードを使って生成されるようにしています。これによって、個別のドキュメントの中のヘッダーやフッターを直接編集する必要がなくなり、プロジェクト全体のドキュメント・フォーマットを揃えることが出来るようになります。
投稿日:2007年08月24日 作成者:yasunaka
今日もcrossnoteの小さな工夫シリーズ、第4弾です。今日は表のオートスケール機能をご紹介します。
仕様書をWordで書いていて、その中に表を載せなければならない場合、皆さんはどうやっていますか? 例えばマイクロソフト社のWordの場合、大きく2つの選択肢があると思います。
1.Word固有の表機能を用いる
2.Excelで表を書いて貼り付ける
Word固有の表機能の場合、表の構造を変更するときに苦労しませんか? 例えば列を追加したいときに、カラムの幅がうまく調整できず、苦労した経験がある人も多いのではないでしょうか? ちなみにWordではカラムをコピーしてペーストすると、単純にインサートされ、表が右側に大きくなります。これによってページをはみ出すと、はみ出したカラムは操作できなくなります。これであせった経験をもつ人も多いのではないでしょうか?
また「列の挿入」で列を増やした場合には、テーブルの全体幅は保ったまま増えるようになっています。これはこれでいいのですが、文字の大きさは変わらないので、1つのカラムの幅がどんどん小さくなり、文字がはみ出して表が汚くなっていきます。
一方Excelのデータを貼り付ける場合には、オブジェクトとして貼り付ける方法と、形式を選択してRTFやWMFやEMFなどのフォーマットで貼り付けることができますね。でも皆さんのなかで、これを使い分けることが出来るようなエキスパートな人はどの程度いるのでしょうか? さらに貼り付けてみると表が途中で切れてしまっていて、うまく表示される貼り付け方を探るという非生産的な作業に没頭した経験をお持ちの方もいるのではないでしょうか?(私です…)
いずれにせよ、少し大きめの表をWordで作るというのは、結構つらい作業だと思います。面倒くさいのでExcelで作ってしまい、別々に管理しているという人も多いと思います。
crossnoteではこの問題に対して、表が横方向にページをはみ出してしまう場合には、表全体のスケールを自動的に調整することで対処しています。例えばカラムを増やしていくと、自動的に表全体をスケールダウンして、横幅がページ幅内に収まるように調整するようにしています。その際には文字もスケールダウンしていきますので、表の形は崩れません。(ただし便利だからといってやり過ぎると文字がどんどん小さくなってしまうので、読みにくくなってしまいますけど)
さらには縦方向にも表を1ページ内で収めたい場合には「1ページに収める」と設定すると、全体が1ページに納めるように調整する機能もあります。
crossnoteは汎用ワープロと比較して見ると非常にシンプルです。見方によっては機能が貧弱に見えるかもしれません。しかし私達は、汎用ワープロ = Fat word processorではなく、プロジェクト用ドキュメント作成ツールとして、さくさくっとドキュメントを作り上げるObjective word processorを目指したいと思っています。