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) | Agrupar os manuais e releases para publicação no Help Center. |
Base de conhecimento (produto) | Agrupar os artigos de FAQ, solução de problemas e tutoriais para publicação no Help Center. Artigos com conteúdo sensível devem ser excluídos do Help Center utilizando a configuração de labels. |
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.
Permissões de usuário
Usamos regras de controle de acesso para gerenciar o que um usuário pode ver ou fazer dentro do Confluence.
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.
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 a 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 e sites, revogação ou permissão de 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.
É possível encontrar e adicionar macros por dois caminhos:
Clique no botão +, na barra de ferramentas e selecione a macro desejada.
Digite / (barra invertida) no corpo do texto e selecione a macro desejada.
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
Como usar
Âncora | A Âncora serve para que possamos indicar um local específico dentro de um conteúdo. | Digite /Âncora |
Colunas | A macro Colunas auxilia na organização de conteúdo, além de possibilitar a criação de layouts para as páginas. | Digite /Colunas |
Exibir filhos | Use a macro Exibir filhos para inserir uma lista das páginas filhas de uma página e seus descendentes. | Digite /Filhos |
Expandir | Essa macro é utilizada para minimizar conteúdos muito extensos ou descrever séries de ações. | Digite /Expandir |
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. | Digite /Lista |
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: Alerta sobre informações importantes, ações reversíveis e requisitos. Apresenta facilitadores de processo ou informações adicionais para maior entendimento de algo. Apresenta informações muito importantes ou ações irreversíveis. Descreve o comportamento do sistema mediante alguma alteração. Apresenta exemplos de configurações e/ou arquivos. | Digite /Painel |
Incluir página | Você pode usar a macro Incluir página para exibir o conteúdo de uma página em outra. | Digite /Incluir página |
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. | Digite /Incluir trecho |
Tabelas | As tabelas são importantes aliadas na organização e agrupação de conteúdos. | Digite /Tabela |
Trecho | A macro Trecho é usada para marcar uma parte do conteúdo de uma página para reutilização. | Digite /Trecho |