Introdução
Aqui, forneceremos algumas diretrizes sobre como padronizar a documentação para uso dos departamentos responsáveis na edição das “Notas de versão”, bem como “Manuais” e outros documentos que possam ser editados para uso interno/externo. |
---|
Índice
|
---|
🖥️ Prints de tela
Nas documentações não podem haver prints de vídeo, desta forma devemos ter dentro dos documentos feitos pelos testers/desenvolvedores prints de telas com boa definição.
Aviso |
---|
Incorreto: A imagem não pode ficar desfocada, com o nome de tela e nem a logo da empresa (Guarani) cortada. |
Dica |
---|
Correto: Imagem com boa definição, apresentando logo da empresa sem cortes e a tela completa para melhor entendimento. |
🟥 Grifos de tela
As imagens inseridas nos documentos devem ser grifadas com formas geométricas retangular ou quadrada no tom vermelho e na espessura 2px ou 3px. Não podem haver setas nas imagens para destacar nenhum campo específico.
Aviso |
---|
Incorreto:Destaques em tela, não podem ser selecionados de outra cor e nem setados. |
Dica |
---|
Correto:Os pontos destacados estão na cor padrão e não há setas na imagem. |
📸 Imagens com conteúdos esmaecidos
Para ocultarmos as informações dos clientes é necessário que isso seja feito de uma forma que esteticamente não fique fora do padrão.
Aviso |
---|
Incorreto: Documento com as informações ocultadas, não pode ficar com aparência de borrão. |
Dica |
---|
Correto: Ocultando as iformações dos clientes para que nenhum dado fique visível e apresentável. |
Aviso |
---|
Incorreto: Não podem sumir as informações contidas nos campos, pois é necessário saber do seu preenchimento. |
Dica |
---|
Correto:Nesta imagem, vemos como devem os ocultamentos dos dados dos clientes. |
💬 Textos dentro das imagens
Não colocar indicações, textos ou explicações por escrito dentro da imagem selecionada para a documentação.
Aviso |
---|
Incorreto: Colocar observações e ou apontamentos dentro dos prints. |
Dica |
---|
Correto: Manter as imagens com boa resolução e sem poluição visual. |
?? - Sistema print
Quando houverem telas de duas situações lado a lado, não colar uma sobre a outra, fazer separadamente as imagens.
Aviso |
---|
Incorreto: |
Dica |
---|
Correto: |
Informações necessárias para documentar
Para fazermos uma boa documentação, quando o ticket é de uma “Solicitação” ele deve conter sempre o relato da ocorrência e a solução, para descrevermos para o cliente.
Primeiro exemplo:
| ||
|
Segundo exemplo:
|
|
|
|
Exemplo Ideal de Nota de versão
|
|
|
?? - Sistema print
Quando houverem telas de antes e depois ou colocar duas situações lado a lado, não colar uma sobre a outra, fazer separadamente as imagens (Imagens 15, 16 e 17).
Não colocar indicações, textos ou explicações por escrito dentro da imagem selecionada para a documentação (Imagem 20).
|
---|