Como documentar

Revisão de 14h58min de 8 de dezembro de 2022 por Jefreson.Simas (discussão | contribs) (Criou página com '==Conceito== Aqui passamos a forma de montar as novas documentações do Sistema, seja na modalidade de HELP ou documentação técnica interna. === Forma de fazer=== Quand...')
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

Conceito

Aqui passamos a forma de montar as novas documentações do Sistema, seja na modalidade de HELP ou documentação técnica interna.

Forma de fazer

Quando formos montar uma documentação devemos considerar alguns tópicos, como os citados abaixo:

O que é Nesta caso devemos dizer para que serve a funcionalidade, mesmo parecendo "obvio" devemos registar o que é o processo ou rotina.

Para que serve Quando entendemos a funcionalidade do processo, muitas vezes conseguimos tomar ações baseadas neste entendimento.

Quais os benefícios e/ou ganhos de uso Muitas vezes os usuários do sistema, não realizam processos, por não entender os impactos e resolver fazer somente uma parte do processo, ou muitas vezes pula etapas, com isso perdendo registros preciosos que poderiam ser usados em analises futuras.

Exemplos Sempre que possível, devemos citar um exemplo, procurando ao máximo ser Atemporal, ou seja, qualificar algo para não ser afetado pelo passar do tempo, ou seja, que faz parte de qualquer época ou tempo. Exemplo - usar datas - leis.