Do tej pory pisalem dokumentacje w XMLu (DocBook), jednak jej pisanie jej strasznie meczace i czasochlonne. Ale zaleta jest mozliwosc latwej konwersji na rozne formaty.
Planuje wkrotce uruchomic pod adresem http://coyote.boduch.net strone (oparta na Coyote CMF :P - demo tutaj http://coyote.boduch.net/demo) z dokumentacja projektu Coyote. Specyfikacja tego systemu ulatwia pisanie dokumentacji.
Jednak fajnie by bylo, aby dokumentacja byla dostepna online, ale rowniez na SVN w postaci plikow XML. Jak to pogodzic? Np. Zend tak ma. Dokumentacja napisana w XML, po konwersji do HTML przeniesiona na strone (online). Ale oni na pewno maja jakis CMS do zarzadzania strona. Czyli konwertuja DocBooka do HTML-a i wrzucaja taki kod do CMSa?