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.

info

Exemplo 1.1

Image Added
Aviso

Incorreto: pois as imagens não podem ficar desfocadas e nem com A imagem não pode ficar desfocada, com o nome de tela e nem a logo da empresa (Guarani) cortada(Imagem 1).

Image RemovedImage Added
Dica

Correto: aqui temos uma imagem Imagem com boa definição, apresentando a logo da empresa sem cortes e a tela completa para melhor entendimento do cliente (Imagem 2).

Image Removed

🟥

.


2. Grifos de tela

As imagens inseridas nos documentos devem ser grifadas com forma geométrica formas geométricas retangular ou quadrada no tom vermelho e na espessura 2px ou 3px.

info

. Não podem haver setas nas imagens para destacar nenhum campo específico.

Exemplo 2.1

Image Added
Aviso

Incorreto:os destaques Destaques em tela devem seguir um padrão, não podendo podem ser selecionado selecionados de outra cor e nem setado (Imagem 1)setados.

Image Removed
Image Added
Dica

Correto: os Os pontos destacados estão na cor padrão e não há setas na imagem, este deve ser um m odelo a ser seguido (Imagem 2).

Image Removed

📸

.


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

Image Added
Aviso

Incorreto:  Um documento Documento com as informações ocultadas, não pode ficar com aparência de borrão (Imagem 1).

Image Removed

ou pixelizado. Sendo assim, o excesso de esmaecimento não cabe.

Image Added
Dica

Correto:Ocultar Deveráocultar todas as iformações informações dos clientes para que nenhum dado fique visível (Imagem 2).

Image Removed

, mas de forma apresentável.

Exemplo 3.2

Image Added
Aviso

Incorreto: Nem mesmo Não podem sumir com as informações contidas nos campos, pois é necessário saber que naquele campo, as informações precisam estar contidas (Imagem 3)do seu preenchimento.

Image RemovedImage Added
Dica

Correto:Nesta imagem vemos como deve ser o padrão da documentação com o esmaecimento dos , exemplificamos a forma no qual devem ser ocultados os dados dos clientes (Imagem 4).

Image Removed

💬

.

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.

Exemplo 4.1

Image Added
Aviso

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

Image Added
Dica

Correto:

(estrela azul)

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 Added
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 (Imagem 1)

.

Image Removed
Image Added
Dica

Correto:

O resultado

Resultado na nota de versão, depois de

buscar

buscarmos dentro dos tickets atrelados

com

, as possíveis soluções

(Imagem 2)

.

Image Removed

Segundo exemplo:

Exemplo 5.2

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

Image Added

Dica

Nota

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

ideal (Imagem 3).

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

ideal”.


Índice
minLevel2
maxLevel2
typeflat
printablefalse

Rv macro
titleVisitantes recentes

📣 Deixe seu feedback

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