Contents
    1. はじめに
    2. うまい使い方
      1. Wiki 的に良い内容とは
      2. ページの名前
        1. 一時的な話題の場合
        2. あとでまとまっている方が良い場合

qwikの使い方

はじめに

qwik が何かと基本的な使い方は以下で読めます。

簡単にまとめておくと、qwik は 任意の ML を作成する事ができます。 また、ML に投稿されたメールは Wiki のページという形で公開されます。

スクラム道の ML に投稿されたメールは原則全部公開されますので、気をつけてくださいね。 もしマズイ情報を書いちゃっても Wiki なんで、すぐに自分で修正できるよ。

Wiki なのでメールの本文に Wiki 記法が利用できます。 記法の説明は以下で読む事ができます。

で、投稿したメールのサブジェクトが ML 上に存在しなければ新規にページを作成します。 また、既にページが存在する場合は、そのページへの追記になります。

うまい使い方

基本的にはメールをやり取りしながら Wiki としてもそれなりに上手くまとまっているのが理想です。 なので、良い Wiki ページの特徴が参考になります。 具体的には、ページの内容と Wikiname を考慮すると良い感じになります。

Wiki 的に良い内容とは

Wiki としては必要な情報のみが書かれている方が望ましいです。 なので、メールの本文としてもあまり意味の無い事や読み飛しているものは書かない方が、後で誰かが読む時に良い感じになります。 具体的には以下かな。

  • 西村です。お疲れ様みたいな挨拶 -> From みたら誰からか分かるし
  • 不必要な引用。全文引用とかすると後で Web から話題を追おうとするとだいぶ残念な感じになります
  • シグネチャ

また、メールだけでは難しいけど、もっと Wiki のコンテンツとしてちゃんと見せたい場合には、以下のような構成を意識すると良い感じになります。

情報のまとめ
それに関する議論

イメージとしては Wikipedia みたいな感じです。 スクラム道場.07のページとかはそんな感じのページにしようと思って、やっています。

ページの名前

各ページにはそれぞれタイトルを付ける事ができます。 通常、ふつうにメールをMLに投げると、メールのサブジェクトがそのままページタイトルになります。 で、このタイトルは qwikの使い方 といった形式で記述するとリンクになります。 そして、このタイトルに合致するサブジェクトでメールを書いた時は、そのページへの追記として扱います。 また、返信等でメーラーがつける Re: とかはちゃんと無視してくれます。 詳しくは、書式一覧詳細版を見てください。

http://qwik.jp/taoofscrum/TextFormat.html

で、普段、僕はページタイトルをつける際に二通りのやり方をやっているので紹介しておきます。

一時的な話題の場合

ML 上の一時的な話題の場合には、あとで Web 上で読み返す事が少ないので、先に書いたようにふつうにメールを投げてページが作成します。 この時のページタイトルは、自動的にサブジェクトがタイトルになっています。 ただし、メール上のやり取りが脱線して、メールのサブジェクトを変えたいなーと思った時は、サブジェクトを変更する前に Wiki ページのページタイトルを変更してからメールするようにしています。 そうしないと、サブジェクトを変えた時点で別のページが作られてしまうので、それを避けるためです。

あとでまとまっている方が良い場合

あとでやり取りを見直したいとか、Web で公開しとくと良さそうなトピックの場合にはやり方を変えています。 例えば、スタッフ希望 のようなまとめ情報は色んな人に見てもらう価値がある場合です。 その場合には、先に Web からページを作成します。スタッフ希望の場合には 「JoinUs」 というページを作りました。 作成したページ名をサブジェクトにしても追記になるのですが、さすがにメールのサブジェクトが JoinUs だと悲しいですよね?? そのため、ページ作成時にページの先頭に "* スタッフ希望" という感じでメールのサブジェクトとして適当なページタイトルを付けておきます。 で、そのタイトルでメールを投げるとあら不思議、ちゃんとそのサブジェクトでやり取りされたメールが スタッフ希望 というページに追記されていきます。

これをやるメリットしては二つあります。 一つは URL がちゃんとした名前になります。 先に書いたメールから自動的に作成されるページの場合には、サブジェクトが ASCII 以外の場合にはシーケンシャルな番号になります。 こんな感じです。-> http://qwik.jp/taoofscrum/1.html で、この番号はリンク記法にも使えるのですが、メール本文中に 第2回 Scrum Boot Camp と書いてもピンと来ません。 また、この話題は以下の URL で公開されていますとか案内するときも、ちょっとダサイですww たぶん、多くの人が http://qwik.jp/taoofscrum/JoinUs.html の方が好ましいと思ってくるはずww

もう一つは、qwik は少し検索機能が残念な感じなので、ページが大量に作成されてくると Web から特定の話題をあとで探そうとすると大変だったりします。 なので、特定の話題をあとで探すのではなく、先にページを作成し、Web 上からすぐに辿れるように Wiki を手入れしておきます。 それから、上のように ML 上のやり取りを作成した特定のページに集約するようにしていきます。 例えば、スクラム道場.07 の場合には、スクラム道場.07 の準備に関するやり取りを集約したかったので、あらかじめ FrontPage から スクラム道場 というまとめページを作成してから、スクラム道場.07 のページをつくりました。 こうしておくと、スクラム道場に関するページは スクラム道場 のページにリンクを追加していけば、あとで自分たちも Wiki だけを見ている人にも使いやすくなります。

だいたい、こんな感じかな??


以下、色んなやり取り

qwikWebを見てハッとしたので勉強会をしましょう。

  • 現状を見て反省
  • お作法を学ぶ
  • 復習
  • レッツトライ

Jul 22, 2011 From: nishimura@n...

ページが作成されてないっぽいのでサルベージしようと思ったけど、作られてたw

あとで、基本的な使い方についてこのスレに書く(予定)

Jul 22, 2011 From: miholovesq@g...

2011年7月22日10:57 Nishimura Naoto <n-nishimura@e...>:

ページが作成されてないっぽいのでサルベージしようと思ったけど、作られてたw

どういう仕組みか全然わかりませんw

私が知ったこと

  • ページを作る
    • メールタイトルをASCIIにすると"メールタイトル.html"のpermlinkができる
    • メールタイトルが日本語なら"連番.html"になる
  • 他の記事へのリンク

Jul 22, 2011 From: nishimura@n...

In <CAPG=6LbHf3gZU2zYeO-kCa6GwHGErjjc+ngaEb67G-9ggFeH7g@m...>,
Miho Nagase <miholovesq@g...> wrote:

ページが作成されてないっぽいのでサルベージしようと思ったけど、作られてたw

どういう仕組みか全然わかりませんw

ページ作成の時になんかエラーになったんかな?

私が知ったこと

  • ページを作る
    • メールタイトルをASCIIにすると"メールタイトル.html"のpermlinkができる
    • メールタイトルが日本語なら"連番.html"になる
  • 他の記事へのリンク

FrontPageといった WikiName をつかってもいけるよ。

くわしくはこちら。

http://qwik.jp/taoofscrum/TextFormat.describe

Jul 22, 2011 From: miholovesq@g...

どうもでーす。
とりあえず全文引用すると悲惨なことになるのは理解したw

Jul 25, 2011 From: nishimura@n...

qwik の使い方について軽くまとめてみました。

ページ上部に移動しました

Jul 28, 2011 From: nishimura@n...

前回のおさらいですが、qwik は ML 上でやり取りしたメールが Wiki という形で保存されます。
なので、Wiki をメンテナンスしながら使っている事を意識すると良い感じに使えます。

前回の続きとして、ページの名前の付け方について書いてみました。

ページ上部に移動しました

ってわけで、とりあえず僕(弊社の??)の使い方をざっと書いてみたので参考になれば幸いです。
僕も最初からこれが出来ていた訳ではないので、参考程度に考えてください。
ただ、qwik は使いこなすと仕事上でも強力な武器になると思うので、スクラム道で練習してみてはいかがでしょうww

Oct 8, 2012 From: miholovesq@g...

シグネチャとか全文引用はqwikが悲惨なことになるので、みんなで qwikの使い方 を読んでqwik力を高めようw


  • -

Miho Nagase
http://twitter.com/miholovesq

Oct 8, 2012 From: nishimura@n...

2012/10/8 Miho Nagase <miholovesq@g...>:

シグネチャとか全文引用はqwikが悲惨なことになるので、みんなで qwikの使い方 を読んでqwik力を高めようw

+1

qwikはいいぞーww

Jul 9, 2013 From: miholovesq@g...

定期ポストw
お暇なときにこちらを見てね
http://qwik.jp/taoofscrum/StudyingQwik.html

Last modified: 2013-07-09 Attached files total: 3MB