Send to your Kindle RIGHT:[[:t/API]] %%APIリファレンスは処理系付属のドキュメント生成ツールで生成されたテキストを体裁付きでページ化できれば尚可。%% APIを実際に呼び出すページ/要素を使って、ページ内にリクエスト例とそのレスポンスを表示。 APIの仕様説明は(--help や /? のように)APIから取得可能。つまりドキュメントはプログラムコードの中に書くということ。ページにはその仕様説明とリクエスト例をAPIから取得して掲載。 その他に(仕様とは異なる)利用法などをページ/内容に書き込んでもいい。 RIGHT:[[:t/API]] %%APIリファレンスは処理系付属のドキュメント生成ツールで生成されたテキストを体裁付きでページ化できれば尚可。%% APIを実際に呼び出すページ/要素を使って、ページ内にリクエスト例とそのレスポンスを表示。 APIの仕様説明は(--help や /? のように)APIから取得可能。つまりドキュメントはプログラムコードの中に書くということ。ページにはその仕様説明とリクエスト例をAPIから取得して掲載。 その他に(仕様とは異なる)利用法などをページ/内容に書き込んでもいい。