WriteSpec
uupaa edited this page Jun 12, 2015
·
6 revisions
npm publish
が終わったら GitHub/Wiki に Markdown で Spec(ドキュメント)を記述します。
npm run wiki
コマンドを実行すると、MyExample.js の wiki ページが開きます。
このページが MyExample.js のドキュメントを記述する wiki のトップページです。
(初めて初めての場合は空白のページが開きます)
https://github.com/ユーザ名/MyExample/wiki/
ページ(Wiki Top, Home)に MyExample の Spec (仕様や設計)を記述します。
MyExample.js で解決したかった事、どんな事に使えるか、何かをするか、そして何かをしないかを記述してください。
ページが長くなる場合は概要に留め、それぞれのトピックについて別のページに記載してください。
https://github.com/ユーザ名/MyExample/wiki/クラス名
ページに MyExample の API Spec (API の仕様)を記述します。
API の具体的な使い方を説明してください。
API Spec だけをシンプルに説明している UTF8.jsや、 Spec と API Spec を詳細に説明している Thread.js を参考にしてください。
Spec の記述が面倒だな… 嫌だな… と感じたら、こちらのエントリを御覧ください。