Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Índice
minLevel2
maxLevel2
indent10px
printablefalse

🖥️

1. 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.

Exemplo 1.1

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.


🟥

2. 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.

Exemplo 2.1

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.


📸

3. Imagens com conteúdos esmaecidos

Nota

Foi combinado com Marina Mattos que serão usadas bases teste com dados genéricos. Sendo assim, não é necessário esmaecer nenhum dado.

Caso seja necessário, seguem instruções para o correto uso do efeito de esmaecimento.

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. Trabalhamos com o efeito de esmaecimento do ShareX, pois é possível sua configuração com um único click esmaecer as informações dos clientes. É necessário utilizar o efeito blur para esmaecer.

Aviso

Proibido usar o PicPick pois ele não cumpre com a lei LGPD.

Exemplo 3.1

Aviso

Incorreto: Documento com as informações ocultadas, não pode ficar com aparência de borrão ou pixelizado. Sendo assim, o excesso de esmaecimento não cabe.

Dica

Correto:Ocultando Deveráocultar todas as iformações informações dos clientes para que nenhum dado fique visível e apresentável., mas de forma apresentável.

Exemplo 3.2

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 exemplificamos a forma no qual devem ser ocultados os dados dos clientes.

Exemplo de como não esmaecer:

image-20241217-132047.pngImage Added

Obs.

💬

: Imagens esmaecidas desta forma os tickets serão devolvidos.


4. Textos dentro das imagens

Não colocar indicações, textos ou explicações por escrito dentro da imagem selecionada para a documentação.

(estrela azul)

Exemplo 4.1

Image Added
Aviso

Incorreto: Não colocar observações e ou apontamentos dentro dos prints.

Image Added
Dica

Correto: Manter as imagens com boa resolução e sem poluição visual.


5. Informações necessárias para documentar

Para fazermos uma boa documentação, quando o ticket é de for uma “Solicitação” ele deve deverá conter sempre o relato da ocorrência e a solução, para descrevermos para o cliente.

Primeiro exemplo:

Exemplo 5.1

Image Modified
Aviso

Incorreto:

Uma documentação

Documentação onde não há o relato da ocorrência e na solução, não ficou explicado o que foi ajustado

para descrevermos para o cliente

.

Image Modified
Dica

Correto:

O resultado

Resultado na nota de versão, depois de

buscar

buscarmos dentro dos tickets atrelados, as possíveis soluções.

Exemplo 5.2

Segundo exemplo:
Image Added
Aviso

Incorreto: Na documentação (testers), não haviam informações suficientes para elaboração da nota de versão

(Imagem 1)

.

Image RemovedImage Removed

Image Added

Informações

Documento do desenvolvedor (Imagem 2).

No documento do desenvolvedor, haviam informações para uma possível documentação da nota de versão.

Image Added

Dica

Correto: Foi utilizada a documentação do desenvolvedor para a solução, mas foi uma publicação com a limitação de informações

(Imagem 3)

.

Image Removed


(estrela azul)

6. Exemplo Ideal de Nota de

versão
Informações

Versão

Image Added

Image Added

Dica

Para documentarmos devidamente, é necessário que o ticket contenha a Solução Simples (

Imagem 1).

Image Removed

Informações

Testers) e Solução Técnica (

Imagem 2

Desenvolvedor).

Image Removed

?? - 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)

Image Added

Dica

Nota de versão ideal (Imagem 3).

Image Removed

Desta forma, conseguimos elaborar uma “Nota de versão ideal”.


Índice
minLevel2
maxLevel2
typeflat
printablefalse

Rv macro
titleVisitantes recentes

📣 Deixe seu feedback

Essa documentação foi útil pra vc? Comente embaixo.