APIリファレンスは処理系付属のドキュメント生成ツールで生成されたテキストを体裁付きでページ化できれば尚可。

APIを実際に呼び出すページ/要素を使って、ページ内にリクエスト例とそのレスポンスを表示。
APIの仕様説明は（--help や /? のように）APIから取得可能。つまりドキュメントはプログラムコードの中に書くということ。ページにはその仕様説明とリクエスト例をAPIから取得して掲載。

その他に（仕様とは異なる）利用法などをページ/内容に書き込んでもいい。