Base de conhecimento
Use Conhecimento para registrar orientações e compartilhar aprendizado da equipe. A aba Artigos mostra os conteúdos em cards; Categorias ajuda a organizar os assuntos.
Caminho: menu lateral → Conhecimento → Artigos. Procure primeiro um conteúdo existente antes de criar outro com o mesmo assunto.
Comece com um resumo curto, organize o corpo em seções com títulos e inclua passos verificáveis. Por exemplo: “Como preparar uma reunião de planejamento” pode ter Antes da reunião, Durante e Depois.
Encontrar e ler um artigo
Pesquise pelo título ou conteúdo disponível na listagem, filtre por categoria quando necessário e abra o card do artigo. A página de leitura começa pelo resumo, apresenta o tempo estimado de leitura e mostra um índice lateral criado a partir dos títulos do texto. Clique em um item do índice para ir diretamente à seção desejada.
Ao ler: confira o resumo para decidir se o artigo atende à sua dúvida; use o índice para saltar à seção necessária; volte ao texto completo para ver o contexto. Em telas menores, o índice pode mudar de posição para caber melhor.
O título e o resumo são reduzidos a uma linha no card quando o espaço é pequeno; abra o artigo para ler o conteúdo completo. Use Comentários para conversar sobre o material e Documentos para consultar anexos, quando essas seções estiverem disponíveis.
Criar ou atualizar um artigo
- Clique em Cadastrar artigo.
- Preencha título, resumo e categoria.
- Se quiser uma capa, cole o link direto HTTPS de uma imagem. Prefira uma imagem horizontal.
- Escreva o conteúdo em Markdown e revise as etapas do formulário.
- Salve e abra o artigo para conferir título, resumo, capa, seções e índice.
Use títulos no conteúdo para estruturar a leitura. O índice é formado por esses títulos; parágrafos sem título não criam entradas. A imagem de capa aparece no card e na página do artigo.
| Campo | Como preencher bem |
|---|---|
| Título | Diga o assunto e a ação principal: “Como registrar uma demanda”, por exemplo. |
| Resumo | Explique em uma ou duas frases o que a pessoa aprenderá. |
| Categoria | Escolha o grupo em que o leitor esperaria encontrar o texto. |
| Imagem de capa | Use um endereço direto de imagem, de preferência horizontal. |
| Conteúdo | Divida instruções longas em seções e listas curtas. |
O campo de conteúdo aceita Markdown. Use # para um título principal, ## para seções e - para itens de lista. Revise a página depois de salvar para verificar se os títulos aparecem no índice.
Perguntas frequentes
A capa não apareceu. O que verificar?
Confira se o endereço aponta diretamente para uma imagem acessível pelo navegador e se começa com https://. O DevFlow usa o link informado, não um arquivo enviado no campo de capa.
Por que uma seção não aparece no índice?
Ela precisa ter um título formatado como cabeçalho no Markdown. Edite o artigo, adicione o cabeçalho e salve.
Editei o resumo, mas o card ainda mostra uma linha só. Está correto?
Sim. O card mostra apenas uma linha para manter a grade legível; o resumo completo aparece na página de leitura.
Posso anexar um arquivo além da capa?
Sim, quando seu perfil permitir. Abra Documentos na página do artigo; veja Documentos e anexos.
Onde crio uma categoria nova?
Use a aba Categorias de Conhecimento, se seu perfil permitir cadastro. Depois volte ao artigo e selecione-a.