ユーザー文書
出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2021/09/20 16:08 UTC 版)
「ソフトウェアドキュメンテーション」の記事における「ユーザー文書」の解説
ユーザー文書は一般にソースコードとは完全に分離したもので、単にそのプログラムの使用法を解説するものである。 ソフトウェアライブラリの場合、コード文書とユーザー文書は実質同じであるが、一般のアプリケーションではそうではない。一方で、LISPマシン[どれ?]では全てのコードに文書が付随していた。これに強力な検索機能を組み合わせて、LISPマシンでは文書を検索して、そこから関連する関数名などをコピー&ペーストでユーザーが作成中のコードに直接利用することができる。[要出典]このレベルの使い易さを実現した最近[いつ?]のシステムというものは見受けられない[誰によって?]。 一般に、ユーザー文書はプログラムの機能毎にその機能を呼び出すのに必要な手順を説明している。よいユーザー文書はさらに、問題発生時の解決策を与えてくれる。ユーザー文書にとって重要なことは、紛らわしい記述を避けることと、付属するソフトウェアに正しく対応していること（最新であること）である。ユーザー文書の形式は定まっていないが、索引が非常に重要である。一貫性と単純性も重要である。ユーザー文書はソフトウェアの契約の一部を構成する。 ユーザー文書の形式として広く採用されている3つの形式がある。チュートリアル形式は新規ユーザーにとっては最も便利であり、特定のタスクを手順を追ってガイドしてくれる。テーマごとの文書形式は、章や節ごとに特定のテーマを解説したものであり、中級ユーザー向けと言える。最後の形式は、コマンドやタスクを単純に辞書的順序で並べたもので、通常それぞれの項目に関連項目への相互参照が記されている。これは自分がどういう情報を求めているか判っている上級ユーザー向けといえる。実際の製品では、これら3つの形式の文書が同時に付属することはあまりないため、ユーザーがその点に不満を持つこともある。 ユーザー文書の提供形式として、パーソナルコンピュータ上のオンラインヘルプしか用意せず、コマンドやメニュー項目に関する情報しか与えないということも多い。この場合、チュートリアルや詳細な情報は、ソフトウェア開発者から特別な支援を受けた出版業者が書籍の形で販売することが多い。
※この「ユーザー文書」の解説は、「ソフトウェアドキュメンテーション」の解説の一部です。
「ユーザー文書」を含む「ソフトウェアドキュメンテーション」の記事については、「ソフトウェアドキュメンテーション」の概要を参照ください。
- ユーザー文書のページへのリンク
