読者です 読者をやめる 読者になる 読者になる

プログラマーな日々

プログラマー兼SEです。好きな習慣:TDD、好きなツール:WorkFlowy、好きな言語:C#、好きなAWSのサービス:Data Pipeline。趣味は開発環境を改善することです。

APIドキュメントを書くなら目を通しておくべき2つのガイド

ドキュメント Sandcastle Java

Sandcastleなどのドキュメント生成ツールが普及し、APIリファレンスを作成するのが当たり前になってきましたが、残念ながら質の低いドキュメントも目にすることも少なくありません。

APIリファレンスを改善したい人には、以下を勧めます。

MSDNマガジン

MSDN マガジン: "Hello World!" コーダーのための API ドキュメント執筆ガイド
この記事は、API ドキュメントを執筆する方法についてのガイドです。ここでは、API ドキュメントの最も重要な構成要素について説明し、効果的な API ドキュメントにする方法についていくつか提案します。また、最大限の効果を得るにはどの部分に時間と注意を注ぐべきかということも含め、優れた概要、サンプル コード、およびリファレンスを作成するためのヒントも提供します。 ...

図 2 リファレンス ドキュメントのスタイルが秀逸です。