terry_u16

> XMLコメントをhelpファイルか何かに変換するのであればまだいいと思いますが、現状だと一覧性がよろしくないです。 XMLコメントからの自動生成はアリかなと私も思っていました。（このあたり詳しくなく、具体的に何を使えば良いかはお恥ずかしながら分からないのですが……。） 加えて、典型的な使用例みたいなものも書いてあげると利用側としては取っかかりが付きやすいのかな、と思っています。一通り使用例を書くのはそれなりに大変ではありますけどね。 > また、 INumOperator など、本家C++のライブラリには無い部分の解説と使用例は書いておかないと、contributor以外の人には使い方が分からない可能性が高いのでは？と思っています。 少なくとも、言語仕様等の理由でC++版から変更を入れているものは説明が必要そうですね（パッと思い浮かぶところでいうと`ModInt`やセグ木周り等？）。C++版と全く同じように使えるところは最悪「C++版と同様です」で一旦切り抜けて、優先度を若干下げても良いのかもしれません。 一方で`INumOperator`についてはラッパークラスが用意されている関係上、ひとまず置いておいても一般的な使用を行う上ではそこまで困らないと思われるので、優先度を下げても大丈夫かもしれませんね。 長々と書きましたが、開発側（という言葉は適切ではないかもしれませんが）の我々だけでは分からない面もあるので、利用者の皆さんのご意見もあればコメント頂ければ嬉しいです……！

> document comment を定数として解釈して HTML 作成時に埋め込めるようにすると嬉しいですね。（library checker の markdown と HTML の変換では、@{[filename].[variable]}で変数を外部から埋め込むことができます。） なるほどそれは知りませんでした……。[ac-library](https://github.com/atcoder/ac-library/tree/master/document_ja)の方も同じような形を取っていますね。二度手間にならなくて済むのは嬉しいです。Document Comment自体は吐き出してしまえばただのXMLですし、やろうと思えばやれそうですね。 最終的にはHTMLが吐けると良さそうですが、体制整うまでは`document_ja`のようなフォルダを切って、[ac-library](https://github.com/atcoder/ac-library/tree/master/document_ja)のようなファイル粒度でmarkdownとしてひとまず公開するのが良いのかなと思っています。まずはC++版にない独自仕様周りを……ということで、`ModInt`, `IMod`あたりについて試しに書いてみます。

このあたり詳しくないので助かります。ありがとうございます！ こういったツールはAPIリファレンスの生成に活用してあげると良いのかな？と当初思っていましたが、別途書いたmarkdownなんかもGetting started的な項目として取り込めるようなので（認識合ってますかね？）、これで全部吐き出すのも良さそうですね。