Esta página contém os detalhes de um projeto de redação técnica aceito para a temporada de documentos do Google.
Resumo do projeto
- Organização de código aberto:
- Mautic
- Redator técnico:
- Favorito Kelvin
- Nome do projeto:
- Base de conhecimento
- Duração do projeto:
- Duração padrão (3 meses)
Project description
Com abstração
Uma base de conhecimento é um repositório centralizado onde as informações são armazenadas, organizadas e compartilhadas. Quando usada externamente, a base de conhecimento é o local em que os usuários podem aprender tudo que precisam saber sobre os produtos ou serviços de uma empresa, a organização e o setor. Uma base de conhecimento interna, por outro lado, é normalmente utilizada como uma forma de permitir que a comunidade/usuários colaborem e distribuam internamente todo o conhecimento e as informações da empresa. Embora o conteúdo de bases de conhecimento específicas varie de acordo com vários fatores, a maioria inclui informações sobre como começar a usar produtos específicos, aproveitar melhor os recursos avançados e superar problemas comuns. O principal benefício de criar e apresentar uma base de conhecimento ao seu público é que ela permite fornecer informações e respostas detalhadas, instantâneas e sob demanda, aos membros, usuários ou à comunidade sem precisar fazer isso individualmente.
O Mautic Knowledgebase é um repositório central de tutoriais, guias de instruções e práticas recomendadas sobre temas relacionados ao Mautic, seja de forma direta (por exemplo, como fazer as coisas no Mautic) ou indiretamente (por exemplo, estratégias de marketing mais gerais).
No momento em que este artigo foi escrito, a base de conhecimento do Mautic é nova e incompleta, e a comunidade quer usar esse projeto para melhorar a maneira de fornecer informações detalhadas e sob demanda à documentação do usuário, permitindo que os usuários finais tenham uma experiência perfeita ao utilizar o serviço. Analisar a base de conhecimento do Mautic foi bastante informativo, mas precisou de tutoriais atualizados, guias de instruções, além de criar novos guias que correspondam à versão do Mautic 3x.
Minhas primeiras impressões ao analisar a documentação Atualmente, a base de conhecimento do Mautic está disponível: https://kb.mautic.org/. Alguns dos tutoriais, guias de instruções e tópicos de práticas recomendadas na documentação não estão atualizados e são esparsos ou incompletos e também não abrangem informações sobre a versão atual do mautic.
Por que sua proposta de melhoria em relação às áreas atuais para as quais eu gostaria de contribuir? A melhoria proposta será melhorar e garantir eficiência, consistência e tranquilidade para todos os usuários finais. Ela conterá tutoriais por escrito e guias de instruções, práticas recomendadas e imagens associadas, além de incluir instruções e explicações sobre como usar cada recurso do mautic, atualizado, fácil de navegar e compreensível.
Análise
A base de conhecimento do Mautic foi escrita no CMS de arquivo simples do Grav e no tema KLB4. Pesquisei muito sobre formas de melhorar a documentação da base de conhecimento
Metas do projeto
- Revise a base de conhecimento.
- Atualize os tutoriais e os guias de instruções para a versão Mautic 3x.
- Crie recursos para a base de conhecimento da comunidade Mautic recém-criada
- Escreva uma série de tutoriais e guias práticos para ajudar os usuários do Mautic a configurar, configurar e usar o aplicativo com mais eficiência.
- Atualize o tutorial em vídeo para se adequar à versão do Mautic 3x.
- Remover imagens e informações obsoletas.
- Reescreva a base de conhecimento para facilitar o entendimento.
- Garantir a implementação adequada do guia/padrão de estilo da documentação da base de conhecimento
Cronograma
Antes de 1o de agosto
- Continue fazendo contribuições para a organização.
- Familiarize-se com a documentação da base de conhecimento e a versão atual do Mautic.
- Aprender novas técnicas e habilidades técnicas de escrita que serão úteis para a implementação do projeto.
Vínculo comunitário (1o de agosto a 1o de setembro)
- Definir canal e horário de comunicação (devido à diferença de horário)
- Refinar minhas metas e definir expectativas para ambos os lados.
- Saiba mais sobre a comunidade e o produto
- Discutir a estrutura de documentação proposta com os mentores e outros membros da organização.
- Finalizar os recursos propostos e outras modificações que precisam ser feitas na documentação existente.
Período da documentação
- Semana 1 (2 de setembro a 22 de novembro)
- Durante esses períodos, trabalharia diretamente com meus mentores para :
- Revise a base de conhecimento.
- Atualize os tutoriais e os guias de instruções para a versão Mautic 3x.
- Crie recursos para a base de conhecimento da comunidade Mautic recém-criada
- Escreva uma série de tutoriais e guias práticos para ajudar os usuários do Mautic a configurar, configurar e usar o aplicativo com mais eficiência.
- Atualize o tutorial em vídeo para se adequar à versão do Mautic 3x.
- Remover imagens e informações obsoletas.
- Reescreva a base de conhecimento para facilitar o entendimento.
- Garantir a implementação adequada do guia/padrão de estilo da documentação da base de conhecimento.
- Considerar a cadência de lançamento, já que a equipe de desenvolvimento estaria ocupada com lançamentos de recursos menores.
Avaliação de projetos (25 a 29 de novembro de 2019)
- Enviar um relatório de projeto e uma avaliação com meus mentores
- Escrever e enviar um relatório sobre minha experiência como participante da temporada de Documentos Google.