Как мы разрабатываем документацию в открытом проекте Embox

Еще можно посмотреть sphinx
Достаточно удобная штука, умеет собираться в версию для web и pdf. Пишут, что поддерживает мультиязычность.