As minhas soluções: DokuWiki
September 3rd, 2009
Wiki’s há muitos, há wiki’s para todos os gostos. Comecei a usá-los muito cedo, lembro-me de usar o wikiwikiweb por volta em 1997. Desde então, aquilo que era uma simples ferramenta tornou-se numa poderosa ferramenta, continuando a ser simples, pelo menos no conceito.
A evolução dos wiki’s levou também a sua diversificação e a especialização, o que torna a escolha mais difícil. Depois de ter usado, testado, administrado todo o tipo de wiki’s precisei de escolher um solução para a minha(e dos colegas de trabalho) documentação técnica. O requisito principal era a simplicidade: simples de gerir, simples de usar, simples de instalar e simples de perceber.
Na altura o wiki que estava a usar e a administrar era um Twiki, mas não me agradava a ideia de ter que sofrer o mesmo para um wiki quase pessoal. O Mediawiki seria uma opção, era simples, conhecido e com funcionalidades interessantes, mas, depende de uma base de dados e era “grande” demais para o fim que pretendia. Eu procurava um wiki para documentação e o nome DokuWiki fazia todo o sentido para o fim, um wiki orientado a documentação técnica.
Instalei e percebi logo que era aquilo que procurava, cumpria todos os requisitos. Destaco algumas características que o tornam apelativo para a documentação técnica, e não só:
- Fácil de instalar
- simples de usar
- bom controlo de acessos
- não necessita de base de dados
- gestão de revisões simples e funcional
- backend simples (plain text + attic)
- temas
- API
- plugins
- syntax highlighting
O DokuWiki mostrou-se ideal para este tipo de trabalho e foi bem aceite pelo resto da equipa, o que mostra que foi a escolha acertada.
Hoje em dia o DokuWiki é a minha primeira opção para a publicação e colaboração on-line. Uso-o, por exemplo, no sitio do Portolinux, serviu para estruturar a minha dissertação de mestrado, é num DokuWiki que coloco toda a informação e documentos das aulas que dou e até faço apresentações(plugin S5). Se tiverem que escolher um wiki não deixem de testar o DokuWiki, no inicio pode parecer simples demais mas é essa simplicidade que vai fazer com que o continuem a usar.