Atlassian: busca em páginas e anexos da documentação
Jean-François H.
Reseña Original
Recomendo o Atlassian para qualquer necessidade de documentação: a busca em páginas e anexos é a melhor que já usei nesse tipo de ferramenta, o custo é baixo e a curva de aprendizado não assusta ninguém. Digo de antemão que o trabalho real começa depois da escolha, com padrões de escrita, estrutura de armazenamento e treino do time para escrever como página web. É o tipo de ferramenta que abre portas para quem vem de redes sociais.
Busca que varre páginas e anexos como o Google
O motor de busca do Atlassian é o ponto que mais me impressionou. Ele procura dentro de páginas e de anexos quase como o Google faria, então quando alguém precisa lembrar onde ficou aquela planilha anexada a um procedimento antigo, a resposta aparece na própria caixa de busca. Isso muda o jogo em times que acumulam documentação por anos e perdem tempo navegando por menus até achar o arquivo certo.
Só que essa qualidade tem uma contrapartida que ninguém comenta antes da implantação. Para a busca funcionar de verdade, você precisa treinar as pessoas a escrever documentos como página web, com hierarquia de Título 1, Título 2 e assim por diante. Quem escreve como se estivesse num editor de texto comum produz páginas sem estrutura, e aí o resultado da busca fica pobre mesmo com um mecanismo tão bom disponível.
Na prática, o que funciona é combinar dois movimentos. Primeiro, definir padrões de escrita claros e uma estrutura de armazenamento que faça sentido para o time. Depois, explicar de forma simples como um buscador web lê títulos e subtítulos. Quando as pessoas entendem essa lógica, elas mesmas passam a encontrar o que produzem, e o suporte informal de dúvidas de documentação cai bastante.
Importação do Word e o layout que se desmonta
A importação e a exportação são outro recurso que ajuda muito a trazer mais gente para dentro da ferramenta e a facilitar o processo de migração de uma base antiga. Em vez de recomeçar tudo do zero, o time aproveita material que já existia em outro formato e só ajusta o que for necessário. Para quem está convencendo colegas resistentes a mudar de hábito, esse caminho de entrada mais suave faz diferença.
O problema aparece quando o documento importado tem algo além de texto comum. A importação de arquivos do Word deixa o layout bagunçado nesses casos, e o resultado exige retrabalho manual para ficar apresentável. Também sinto falta de mais opções de importação, como Visio ou MS Project, porque hoje esses conteúdos precisam ser reconstruídos de outra forma dentro do Atlassian.
Não é um defeito que inviabilize o uso, mas é uma aresta que aparece justamente nas migrações maiores. Vale planejar tempo para revisar o que entra por importação e para decidir o que realmente precisa ser trazido e o que pode ser reescrito já no formato de página web.
Como levo pessoas resistentes a documentar
A facilidade de uso é o que mais ajuda a trazer pessoas relutantes para dentro da ferramenta. Quem nunca gostou de documentar costuma achar que a tarefa pertence a outra pessoa, e o Atlassian reduz esse atrito inicial porque a operação é intuitiva. Já usei essa característica como argumento para começar a colaboração sem exigir que todos fossem experts no assunto.
O aspecto de comunidade é outro ponto forte. Recursos como blog comunitário, curtidas e comentários aproximam gente acostumada a redes sociais como o Facebook, e isso cria um ambiente familiar. Em times espalhados por locais diferentes, esse conjunto funciona muito bem para trabalhar junto em um problema comum ou em um procedimento de instalação, com cada pessoa contribuindo na sua parte e comentando o que já foi feito.
A ressalva fica na evolução da interface. As atualizações movem botões e menus, e acompanhar tudo isso pesa para o usuário. Um aviso de "o que mudou desde o seu último acesso" dentro da própria tela resolveria boa parte do incômodo, porque a pessoa retomaria o trabalho sabendo onde as coisas estão agora, em vez de descobrir isso na tentativa e erro.
Depois de um tempo de uso, minha conclusão continua a mesma do início: o Atlassian é uma escolha sólida para documentação, com busca excelente, custo baixo e uma comunidade que engaja quem normalmente foge da tarefa. O ajuste fino de padrões, o cuidado na importação e a comunicação das mudanças de interface são o que separa uma base desorganizada de uma documentação realmente útil no dia a dia.
Más reseñas de Atlassian
¿Evaluando Atlassian?
Obtén una cotización personalizada de Atlassian según tus necesidades.
Hablar por WhatsApp
por Atlassian
Atlassian: colaboração e gestão do desenvolvimento de software para equipes que trabalham com planejamento, conhecimento e código em equipe. Conheça recursos, documentação e critérios de avaliação para comparar a solução.