今のドキュメント、きれいなんですけど html なので書きづらいです。
Maven の apt 形式にしませんか？
デザインはcssをいじれる程度なのであまり凝ったことはできません。
が、メンテナンスが容易なほうがいいんじゃないでしょうか。
html から apt への移行は自分がやってもいいと思っています。
どうでしょう？