ソフトウェアドキュメンテーション
統一モデリング言語(UML)
ユーザー文書は一般にソースコードとは完全に分離したもので、単にそのプログラムの使用法を解説するものである。
ソフトウェアライブラリの場合、コード文書とユーザー文書は実質同じであるが、一般のアプリケーションではそうではない。一方で、LISPマシンでは全てのコードに文書が付随していた。これに強力な検索機能を組み合わせて、LISPマシンでは文書を検索して、そこから関連する関数名などをコピー&ペーストでユーザーが作成中のコードに直接利用することができる。このレベルの使い易さを実現した最近のシステムというものは見受けられない。
一般に、ユーザー文書はプログラムの機能毎にその機能を呼び出すのに必要な手順を説明している。よいユーザー文書はさらに、問題発生時の解決策を与えてくれる。ユーザー文書にとって重要なことは、紛らわしい記述を避けることと、付属するソフトウェアに正しく対応していること(最新であること)である。ユーザー文書の形式は定まっていないが、索引が非常に重要である。一貫性と単純性も重要である。