Artefatos em Wiki

Todos os artefatos armazenados no Wiki devem ser organizados de forma estruturada, para permitir uma melhor visualizacao e controle de permissoes e/ou exportacao de conteudo.

As regras basicas para isso sao definidas aquiDevido a enorme flexibilidade, as paginas Wiki podem rapidamente formarem um complicado emaranhado de informacoes. Assim, organizar de alguam forma seu conteudo é interessante.

As regras para a colocacao de artefatos (paginas) em wiki sao:

1. Utilize tags.
2. Tenha certeza que o item 1 foi contemplado.
3. Revise o item 2.
4. Tenha atencao no local (hierarquia) onde a pagina esta sendo criada.
5. Revise o item 4.
6. Evite acentuacao e/ou caracteres especiais nos nomes de paginas.
7. Para artefatos (paginas) que sao imutaveis, ou deveriam ser, por exemplo, atas de reunioes, release notes, registro de participacao, relatorios, etc, procure iniciar o nome do artefato com uma data, seguido de um espacao e um traco. Exemplo: 2008.03.05 - Merlin - Liberacao Alpha1
8. Todas as datas seguem o formato: AAAA.MM.DD, o que facilita a ordenacao em qualquer dispositivo.
9. Revise o item 8.
10. Para artefatos (paginas) de projetos de clientes, vide secao Página de Projetos, abaixo.
11. Todos os títulos e subtítulos (de quaisquer níveis), quando formados por palavras compostas, Devem Possuir as Iniciais em Maiúsculas, com excecao das preposicoes, adverbios e adjuntos, como "em, ou, a, de, para, com, do, de" e outros semelhantes.
12. Tenha cuidado com o nivel de permissao dado a pagina criada. Na duvida, procure informacoes junto a outras pessoas da equipe, com gerente ou com o administrador do sistema.
13. Revise as permissoes das paginas.
14. Revise o item 13, agora com atencao! - Lembre-se, seu login é armazenado no sistema, e o vazamento de informacoes é facilmente localizavel, sendo voce o responsavel.
15. Adicione comentarios uteis as edicoes realizadas nos artefatos (paginas, anexos, etc).
16. Revise o item 15.
17. Se for uma edicao de pequeno vulto, marque o item "Minor change" ao rodape da pagina, para evitar notificacoes para usuarios cadastrados no artefato.
18. Ao final, antes de salvar, revise o conteudo: nome do artefato, links quebrados, permissoes e comentarios.
19. Nao precisa revisar o item 18, senao voce vai perder muito tempo
20. Publique.

Páginas de projetos

Páginas de clientes 

Convenciona-se que os nomes das páginas dos clientes sigam a nomenclatura:

<sequencia> - <data> - <nome do cliente> - <cidade>, <uf> - Home

Onde:

sequencia: é um número sequencial a partir de 1, que indica o n-ésimo cliente conquistado.

data: é, como todas as datas no wiki da empresa, formatada com AAAA.MM.DD e indica a data de catalogação do cliente. Útil para fins históricos e estratégicos da empresa.

nome do cliente: é o nome do cliente reconhecido pela empresa e seus colaboradores.

cidade e uf: informam a localização do cliente 

Home: indica a página centralizadora dos projetos do cliente. 

 Exemplos:

1 - 2008.06.25 - Panazollo - Canoas, RS - Home

Subpáginas de clientes

Servem para centralizar diversos projetos em um cliente. Estão localizadas sempre como elementos-filho da página Home do cliente.

A nomenclatura dessas páginas é dada por:

<sequencia> - <data> - <nome do cliente> - <nome do projeto> - <cidade>, <uf> - Home

Onde:

sequencia, data, cidade, uf e Home: são análogos às páginas do cliente e, embora possam parecer informações redudantes, algumas vezes projetos do cliente podem existir em diversas localizações.

nome do projeto: deve ser identico ao utilizado no Jira.

As páginas de informacoes de cada projeto nao precisam seguir estruturas definidas, mas a premissa de colocar a data de criacao do documento (lembrando que esta regra vale para todas paginas wiki da empresa) deve ser mantida.

Na figura anexa,  uma ideia de como deve ser isso na pratica diaria.