В настоящее время я начинаю писать документацию для одного из наших проектов. Из соображений простоты мы выбрали формат Almost Plain Text (APT) Format, подробнее смотрите здесь: http://maven.apache.org/....