ドキュメントの作成
Posted on :| コメント (0) | トラックバック (0)
シンプルぱっと2正式版に向けたドキュメントの作成が終りました。 ドキュメント作成はソフト開発の中でも最もしんどい作業だと思います。特に、一般の人を対象にしたドキュメントは大変です。
ドキュメント作成が大変になってきている背景として、競馬ソフトを使う人の裾野が広がったことがあげられます。
今までだったら配慮をしなくても良かった点を配慮する必要が出てきました(一言で言うなら全くの初心者が増大しました)。
ただ、ドキュメントを細かく書いても読んでくれない事が多く、
これがサポートコストの増大につながっています(中には隅々まで読んでくれる人がいますが)。
本当なら取説のいらないインターフェースを備えているソフトが理想ですが、自転車や包丁など機能が明確なものと異なり、 一般化が難しいソフトの世界では夢のまた夢です。もちろん、その中で分かりやすいインターフェースというのは常に考えていますが。
質問の多い項目などはよくある質問としてまとめていますが、それでも似たような質問が絶えません(サポートコストの増大は、 開発作業に深刻な影響を与えます)。
導入前に「○○できますか?」という質問も多く、この負担も多く、ドキュメント自体のあり方についても考えています。
また、ヘルプコンパイラを通す前に、HTML HELPの構成を整えるソフトの使い勝手が悪く、 環境を移すとイチから再構築を強いられたり、 イメージやHTMLファイルが勝手に管理外の場所にコピーされるのも非常に苦痛です(最新版管理が破綻)。 ツールの入れ替えも検討しています。
どのようなところでつまづくか、あるいは情報提示のあり方について一家言ある方は、コメントいただけると幸いです。
トラックバック
このエントリーのトラックバックURL:
コメント
- Search
- 最近の記事
- カテゴリー
- 過去の記事
-
- 2011年05月
- 2011年03月
- 2011年02月
- 2011年01月
- 2010年12月
- 2010年11月
- 2010年10月
- 2010年09月
- 2010年08月
- 2010年07月
- 2010年06月
- 2010年05月
- 2010年04月
- 2010年03月
- 2010年02月
- 2010年01月
- 2009年12月
- 2009年11月
- 2009年10月
- 2009年09月
- 2009年08月
- 2009年07月
- 2009年06月
- 2009年05月
- 2009年04月
- 2009年03月
- 2009年02月
- 2009年01月
- 2008年12月
- 2008年11月
- 2008年10月
- 2008年09月
- 2008年08月
- 2008年07月
- 2008年06月
- 2008年05月
- 2008年04月
- 2008年03月
- 2008年02月
- 2008年01月
- 2007年12月
- 2007年11月
- 2007年10月
- 2007年09月
- 2007年08月
- 2007年07月
- 2007年06月
- 2007年05月
- 2007年04月
- 2007年03月
- 2007年02月
- 2007年01月
- 2006年12月
- 2006年11月
- 2006年10月
- 2006年09月
- 2006年08月
- 2006年07月
- 2006年06月
- 2006年05月
- 2006年04月
- 2006年03月
- 2006年02月
- 2006年01月
- 2005年12月
- 2005年11月
- 2005年10月
- 2005年09月
- 2005年08月
- 2005年07月
- 2005年06月
- 2005年05月
- 2005年04月
- 2005年03月
- 2005年02月
- 2005年01月
- 2004年12月
- 2004年11月
- 2004年10月
- 2004年09月
- All Entries
- Comments
-
- 地震とストレージの関係
永ちゃん (03/18)
吉田章太郎 (03/19)
- 地震の影響
永ちゃん (03/12)
吉田章太郎 (03/13)
- 無茶の代償
副将軍 (02/17)
吉田章太郎 (02/17)
- 本年の展望
yodog (01/09)
吉田章太郎 (01/20)
- ノロウィルス感染
永ちゃん (01/17)
吉田章太郎 (01/20)
- 地震とストレージの関係
- TrackBacks
-
- Powered by