BathyScaphe

BathyScapheWiki

ヘルプ製作の流れ

ヘルプはどのように作られるのか

ひとりよりふたり。ふたりよりさんにん。

system.png BathyScaphe ヘルプは、乱暴な例えをすれば、投稿作品を元に雑誌を編集するようなシステムで製作されます。

 多人数で柔軟に編集できる Wiki の利点を生かし、もっとも労力が費やされる部分である「原稿の作成」を短期間で行うことができます。それぞれのトピックに対して知識を持っている人は、html の知識やわずらわしい(?)開発チームへの参加なしに、気軽にその知識を BathyScaphe ヘルプに提供、還元することができます。

 いっぽう、こうして集まった原稿は、ヘルプの表記ガイドラインや、校正をしてくれる人の手によって、不特定多人数での作業の欠点である、「表記の不統一性」「全体的なバラバラ感」をできるだけ解消する作業が行われます。統一した視点からの校正作業を行うことで、高い品質のオンラインヘルプを提供することが可能になります。

 html を書くことが得意な人は、これらの原稿を元に適切な html ファイルを作成することに専念できるため、作業効率が向上します。html 化されたファイルも、再び校正され、リンク切れなどのミスをできるだけ防ぎます。

 最終的に、ヘルプビューアに最適化するための索引ファイル作成、特殊な meta タグの追加等を行い、完成したヘルプファイル群が BathyScaphe の CVS リポジトリに追加されます。

BathyScaphe の新しいヘルプ製作システムは、

  • 多くの人が気軽に得意な分野の作業に参加でき、
  • かつ、高品質なヘルプを完成させる

ための、実験的な試みとして、今その最初の作業が行われているところです。

現在の進行状況

  • ステップ1 - 原稿の作成/編集/校正のサイクル←おおむね完了
  • ステップ2 - 校正専任担当者による全体のチェック←ほぼ完了
  • ステップ3 - html 作成←完了
  • ステップ4 - html の校正/仕上げ/コミット←完了!完成!

Last Modified: