Sobre o Confluence
Para que os usuários criem, colaborem e organizem toda a documentação em apenas um lugar, a NDD adotou o Confluence como sua ferramenta.
Através de páginas e espaços, os times podem criar e colaborar nos diversos materiais que um Produto pode possuir.
Espaços
As páginas são armazenadas em espaços, neles é possível colaborar no trabalho e manter todo o conteúdo organizado. Veja abaixo como organizamos a nossa documentação.
Nome do espaço
Objetivo
Documentação (Produto) | Escrever Agrupar os Manuais e Releases para publicação no Help Center. | ||
Base de conhecimento (Produto) | Escrever Agrupar os artigos de FAQ, solução de problemas e tutoriais para publicação no Help Center.
|
| Dica |
|---|
Páginas
De vida aos seus documentos aqui, todo o conteúdo que o usuário visualizará serão criados nas páginas de forma dinâmica e colaborativa.
| Dica |
|---|
Permissões de usuário
Usamos regras de controle de acesso para gerenciar o que um usuário pode ver ou fazer dentro do Confluente.
Espectador é um usuário com a permissão apenas de visualização. Ele pode acessar todos os conteúdos disponíveis na ferramenta, pode criar comentários e reagir sobre o conteúdo.
| Informações |
|---|
Solicite o acesso através dos administradores paulo.henrique@ndd.tech ou catarine.silva@ndd.tech. |
Colaboradores são usuários que tem permissões de visualização e criação de conteúdo. Tem acesso à todos os espaços, porém a sua colaboração fica restrita apenas aos espaços relacionados a unidade de negócio em que atua.
Administradores são usuários que realizam a administração do Confluence, desde a criação de espaços, sites, revogam e permitem o acesso de usuários Espectadores ou Colaboradores.
Macros
A criação de conteúdo no Confluence é feita através de macros. São funcionalidades complementares ao texto, que adicionam mais dinamismo ao layout das páginas.
Padrão de macros
O Confluence permite a utilização de uma gama de macros, com diferentes funcionalidades. Apesar disso, é importante que a documentação de todos os produtos seja coerente visual e graficamente, por isso, esse conteúdo descreve quais macros e em que contexto podem ser utilizadas. Confere:
Macro
Descrição
Âncora | A âncora serve para que possamos indicar um local específico dentro de um conteúdo. | |||||||||||||||||
Colunas | A Macro Colunas auxilia na organização de conteúdo, além de possibilitar a criação de layouts para as páginas. | |||||||||||||||||
Exibir Filhos | Use a macro Exibir Filhos para inserir uma lista das páginas filhas de uma página e seus descendentes. | |||||||||||||||||
Expandir | Essa macro é utilizada para minimizar conteúdos muito extensos ou descrever séries de ações. | |||||||||||||||||
Listas | Auxilia na organização de artigos que contém passo a passo ou instruções sequenciais. Temos dois tipos, as ordenadas e não ordenadas. | |||||||||||||||||
Painéis | Os painéis são valiosos recursos de apoio visual para o texto e servem para destacar algum tipo de informação. Existem cinco tipos de painéis:
Descreve o comportamento do sistema mediante alguma alteração.
| |||||||||||||||||
Incluir página | Você pode usar a macro Incluir Página para exibir o conteúdo de uma página em outra. | |||||||||||||||||
Incluir trecho | A macro Incluir trecho é usada para exibir o conteúdo “extraído” (ou seja, um segmento de) de uma página em outra. | |||||||||||||||||
Tabelas | As tabelas são importantes aliadas na organização e agrupação de conteúdos. | |||||||||||||||||
Trecho | A macro Trecho é usada para marcar uma parte do conteúdo de uma página para reutilização. |