Joguei meu wiki DokuWiki pago em um contêiner Docker e minha documentação finalmente faz sentido

Perdi a conta de quantos aplicativos de anotações que usei. Desde o uso do SimpleNote até o uso do Notion como banco de dados para minhas anotações e, claro, o básico como o Google Keep. Alguns deles são ótimos para coletar ideias, enquanto outros possuem uma ótima interface. Em outros lugares, alguns prometeram providenciar tudo para mim, mas você sabe como é a história.

Eu precisava de um sistema robusto que não servisse apenas para anotar pensamentos fugazes, mas também para documentar coisas e informações que planejava manter por anos. Coisas como as configurações do meu servidor doméstico, arquivos Docker Compose, até mesmo minhas notas de rede e comandos do Linux que raramente uso. Eu precisava de um lugar onde basicamente toda a documentação do meu projeto pudesse ser armazenada permanentemente.

Além disso, eu não queria pagar uma assinatura pelo que se tornara essencialmente meu banco de dados pessoal, então instalei o DokuWiki. Este wiki pessoal é executado em um pequeno contêiner Docker no meu NAS, armazena tudo como arquivos de texto simples em vez de um banco de dados e se concentra em um trabalho. Esta tarefa é me ajudar a construir uma base de conhecimento pesquisável que possuo inteiramente. Eu gostaria de ter instalado antes.

Eu uso Notion, Obsidian e Evernote apenas para voltar ao Google Keep

Mantenha seus aplicativos sofisticados de anotações para você

Eu precisava de documentação, não de outro aplicativo de notas

Informações fáceis de encontrar meses depois

O maior motivo pelo qual desisti de um aplicativo tradicional de anotações, ou mesmo de algo como o Obsidian, é que minhas anotações não são apenas anotar pontos. Por exemplo, quando implanto um novo código Docker, não apenas salvo o arquivo de compilação, mas também documento coisas como mapeamento de volume, variáveis ​​de ambiente, configurações de rede e até mesmo coisas como regras de proxy reverso ou locais alternativos que posso ter configurado durante o processo de configuração.

Já estive em uma situação em que precisei restaurar um serviço e não tinha ideia de como o instalei e quais atalhos usei. Você sabe o que dizem: uma vez mordido, duas vezes tímido.

O aplicativo Notas certamente pode armazenar todas essas informações, mas não vincula as informações relacionadas. DokuWiki sim. Cada página pode ser vinculada a outra página, portanto, em vez de manter dezenas de documentos desconectados, construo gradualmente páginas de base de conhecimento em meu NAS. Eles estão vinculados à documentação do repositório, que está vinculada aos serviços Docker, que estão ainda vinculados aos procedimentos de backup e aos nós de solução de problemas.

Não preciso duplicar as informações em vários nós porque posso apenas consultar a página onde elas já existem. Quando revisito um projeto seis meses depois, não preciso me lembrar de nomes de arquivos ou estruturas de pastas; Posso simplesmente começar na página principal e seguir a trilha dos links como se explicasse o projeto para outra pessoa.

Também comecei a fazer uso intenso de namespaces para separar diferentes áreas da minha documentação. Quer se trate de um aplicativo auto-hospedado, de rede ou até mesmo de configurações relacionadas à fotografia, cada um tem sua própria seção. Ele mantém tudo organizado sem depender de hierarquias de pastas complexas no meu NAS e, quando procuro informações, posso simplesmente procurá-las.

Simplicidade é a maior força do DokuWiki

Mais capaz do que parece

A simplicidade e a natureza básica do DokuWiki são o motivo pelo qual ele ficou comigo em relação a outros aplicativos de anotações ou ferramentas auto-hospedadas. Não há necessidade de manter um banco de dados, o que elimina todos os níveis de complexidade. Cada página é basicamente um arquivo de texto em meu disco, o que facilita os backups e também significa que posso acessar facilmente esses arquivos mesmo se eu parar de usar o DokuWiki.

Na verdade, toda a minha rotina de backup ficou mais fácil porque todos os arquivos são basicamente apenas uma pasta no meu NAS. A natureza agnóstica da plataforma de arquivos é um grande vendedor para mim. Se algum dia eu decidir mudar para outra plataforma, todo o trabalho que fiz não ficará preso a um formato proprietário ou a um banco de dados complexo. Todos os arquivos ainda são legíveis, portáteis e fáceis de migrar sempre que eu quiser.

Mas esta simplicidade não significa que o DokuWiki não tenha recursos. Ele tem muitos acréscimos de qualidade de vida, e o histórico de revisões é um recurso em que confio com mais frequência do que espero. Cada correção é salva automaticamente, portanto, se eu substituir uma configuração funcional ou remover algo acidentalmente, posso comparar rapidamente as versões anteriores e restaurar a correta. O DokuWiki também oferece suporte a um ecossistema de plug-ins que ajudam a ampliar a funcionalidade. Ainda estou descobrindo esse lado do DokuWiki, mas alguns plugins para destaque de sintaxe e melhor navegação já melhoraram minha experiência.

Ao contrário de alguns dos novos programas de anotações do mercado, a interface do DokuWiki não é particularmente moderna. Na verdade, pode parecer algo saído dos anos 90, mas isso realmente não importa. Você precisa de um local para armazenar suas anotações, e o DokuWiki faz um ótimo trabalho nisso.

A ferramenta de documentação que eu realmente usei

O DokuWiki não substituiu todos os aplicativos de anotações para mim. Quando estou lidando com informações rápidas e descartáveis, costumo usar o Google Keep ou o SimpleNote. Para qualquer coisa que seja importante e precise ser preservada a longo prazo, todas essas informações vão para o DokuWiki – a documentação, as alterações de rede e as configurações de servidor para cada contêiner docker que implanto. Ultimamente comecei até a usá-lo para planejar viagens. É exatamente o que eu queria, não outro aplicativo de produtividade com uma lista de recursos além do que posso contar, mas uma ferramenta simples e direta que resolve bem um problema, e é isso.

Link da fonte