マニュアル担当†
コメント†
- org のヘルプをcvs投入していただけないでしょうか? ドキュメント類のまとめページは devに作ったらどうかと思っております。 -- merlin
- ref.inc.php マニュアルのインライン要素の場合に無効なオプションがいっぱい入っていますがこれは間違いでしょうか? -- merlin
- 間違ってますね。 nowrap,wrap,around,left,center,right が無効です。 -- にぶんのに
マニュアルの作成方針について†
開発日記/2004-08-24 から移動
余談ですが、特に使い勝手にかかわる部分(外部動作)について、とあるバージョンから有効になったり、無効になったりしたものはそれがわかる様に補足していただけると助かります。また、カスタマイズ要素のない部分(内部動作にかかわる部分)は(何も)書かずとも良いと思います。役割的には「ユーザー」マニュアルですから。 -- henoheno
- ここに書くのが妥当かはわかりませんが、プラグインマニュアルの作成・修正*1を行ったのは概ね私のようなので、一応見解を書いておきます。 -- にぶんのに
- 外部動作の変更箇所はバージョンを併記する件について
- 情報を記述する意義はあると思います
- 記述を工夫しないと読みにくくなる懸念あり。もっともプラグインマニュアルに限ってはリファレンス的意味合いが強いため、影響は少ないと思います
- 現状の記述修正が必要。中途半端な記述を行うと誤解を生む可能性があるので、統一すべき。ただ、ここに労力を使うなら他のマニュアル整備に注ぐべきでは
- 今後のメンテは多少煩雑化する。管理やメンテの方針を明記する必要性があるのかもしれません
- 内部動作にかかわる部分を記述するかどうかについて
- 現状、プラグイン内設定は用途に関わらず一律挙げている
- 元々手間の掛かる項目にカスタマイズ要素かという判断(手間)が増える
- カスタマイズ要素かという判断が妥当かどうか明確な線引きがない
- 一律記述した方が記述漏れをチェックする時には楽
- ユーザーマニュアルと割り切って全く記述しない(削除する)方が良いかも
- スクリプトは用途に合わせてカスタマイズするもの、という個人的な思想の下、カスタマイズ可/不可の一定の目安としてdefineを挙げていますが、ユーザーには関係ない項目なので。
- なお、PLUGIN_INCLUDE_MAXの説明で1.4.4以降追加された旨を記述してくれた方がいましたが、上に挙げた理由から記述を削除しています。現状に合わせて、内部動作のプラグイン内設定も追加しています。あしからず。
えっと・・・*2わたしもここに・・・(^^; pukiwiki.org のマニュアルも同期取らないと後から後から間違える人が多発するんですけど・・・(結構誤りも多いし)-- みこ