[Seasar-kvasir 33] Re: 初期ドキュメント完成（Re: ドキュメント作成手順について）

[Tsunenaga Hanyuda]

羽生田です。

ドキュメントへのコメントです。
表現の問題に関する部分が多いので、コメントとして役に立つかどうかわかりま
せんが。

「インストール」

・"他のOSの場合も...", "現在、Sun JDK1.4.2_08と..."の二箇所については本
文ではなく注釈の印象が強いのですが、そのように表現してしまって構いません
か？(つまり「囲み」みたいな見た目にするということ)

・"設定を確認して下さい。" -> "Tomcatの設定を確認してください"のほうが親
切だと思います。

・"あとはサイト管理ツールを使ってWebサイトにコンテンツを配置したり外観を
カスタマイズしたり機能を追加したりしてオリジナルのWebサイトを構築して下
さい。" -> "ここからはサイト管理ツールを使って...(中略)...オリジナルの
Webサイトを構築していきます。"という方が気持ちが盛り上がるかも。

「始めの一歩」
＊すいません、ちょっと色々多いのでまとめてから再度投げます。


ひとまずここまで、ということで。
--
羽生田 恒永
hanizo ＠ pm.highway.ne.jp


YOKOTA Takehiko wrote:
> 横田です。
> 
> 初期ドキュメントがようやく完成しました。これでKvasir/Soraの基本的な
> 使用方法が分かるはずです。
>   http://www.skirnir.net/~skirnir/kvasir/documents.zip
> 
> さてドキュメントをWebサイトに置きたいのですが、羽生田さん、以下のこと
> をお願いできますか？
> ・documents.zipの中のhtmlフォルダの中身がHTML形式のドキュメントです。
>   日本語がおかしかったり図が冗長だったり記述が不足していたりしないか
>   確認して、問題があれば連絡を下さい。
> ・最終的にOKとなったら、Webサイトに置いて下さい。
> 
> なおドキュメントを何形式で書くかはまだ未定ですが、取り急ぎ最初のドキュ
> メントは出したかったので、今はWiki形式で書いてKvasir/SoraでHTMLに変換
> しています。（なので修正する際はオリジナルのwikiテキストを直すように
> して下さい。documents.zipのwikiフォルダに入っています。）
> 
> 他の皆様も、ドキュメントを読んでご意見をいただければと思います。また
> 「こういうことを教えて！」「これはどうやるの？」などもお知らせいただ
> ければと思います。
>