[Goah-devel] Dokumentaatiosta

[Tapio S. <ta...@ne...>]

Käytettävä alusta dokumentoinnille on siis wiki. Nyt tarvitsee enää 
löytää sopiva järjestelmä ja ottaa se käyttöön ;)


Olen itse asentanut ja käyttänyt MediaWikiä jonkinverran. Järjestelmä 
ainakin takuulla taipuu tarpeeseen, sillä tuo mediawikihän pyörittää mm. 
wikipediaa. Löytyy osoitteesta http://www.mediawiki.org/wiki/MediaWiki

Plussapuolelta löytyy helppo käyttöönotto ja helppokäyttöisyys, 
miinuksia sitten ropisee äärettömän huonosta muokattavuudesta niin 
ulkoasun kuin toimintojenkin osalta.


Toinen ihan mielenkiintoisen oloinen järjestelmä näyttäisi olevan 
DokuWiki (http://wiki.splitbrain.org/wiki:dokuwiki). Tästä en osaa sanoa 
yhtään mitään, muuta kuin että tietojen tallennus plaintext-muodossa 
tietokannan sijaan on aika mielenkiintoisenoloinen ratkaisu.

Plaintext -pätkistä olisi oletettavasti helpompaa generoida ihan 
printattavaa manuaalia jossain vaiheessa.

Molemmat noista ovat php-kudelmia, mutta se tuskin muodostuu kynnykseksi.


Sourceforge tarjoaa myös jonkinlaisen wikin käyttöön, mutta siitä ei ole 
mitään käsitystä. Pikaisella vilkaisulla se vaikutti ehkä aavistuksen 
kankealta verraten vaikka mediawikiin.

Wikimatrix.orgista löytyy tietty vaikka kuinka paljon erilaisia 
järjestelmiä, mutta sivuston vertailutietojen perusteella ei ainakaan 
osunut silmään mitään mikä olisi miellyttänyt.

-- 
Tapio Salonsaari