Skip to content

docs: adicionar screenshots reais ao README (PT/EN) - #16

Merged
janeiaraujo merged 1 commit into
mainfrom
docs/add-screenshots
Aug 3, 2026
Merged

docs: adicionar screenshots reais ao README (PT/EN)#16
janeiaraujo merged 1 commit into
mainfrom
docs/add-screenshots

Conversation

@janeiaraujo

@janeiaraujo janeiaraujo commented Aug 3, 2026

Copy link
Copy Markdown
Owner

O que fecha

O último item pendente da lista de melhorias antes de publicar: nenhuma imagem no README. Um projeto de UI sem screenshot perde a maioria dos visitantes em segundos — era o item de maior impacto e menor esforço, mas dependia de rodar a aplicação de verdade (o sandbox onde venho trabalhando não alcança o Mongo), então ficou esperando você me enviar as capturas.

O que mudou

6 screenshots reais da aplicação rodando (não mockups) — inclusive mostrando dados dos incidentes/KBs que semeei via seed-sample-data.js:

  • Captura Rápida — os campos de voz, logs e upload de imagem do PR Captura Rapida multimodal, fluxo completo de incidentes e reorganizacao de integracoes #11
  • Incidentes — lista com os três estados do lifecycle (aberto/reconhecido/resolvido) e origem manual/automática
  • Knowledge Base — listagem com status de rascunho/revisão/publicado
  • Artigo de KB — o KB gerado a partir de um incidente resolvido, vinculado de volta a ele
  • Busca Inteligente
  • Post-Mortem — modal de criação com os templates (Google SRE, Netflix, AWS Well-Architected)

Reduzi de 1920px para 1400px de largura e quantizei pra 200 cores antes de comitar — ~412KB no total pras 6 imagens (média de ~65KB cada), sem perda visível de nitidez em texto/UI. Seção adicionada logo após os badges, antes do índice, nos dois READMEs (PT/EN).

Test plan

  • Ver o README renderizado no GitHub e conferir que as imagens carregam e o texto continua legível

Fecha a lacuna apontada antes de publicar o projeto: nenhuma imagem no
README, que é o item de maior impacto na primeira impressao de quem
visita o repositorio.

6 capturas de tela reais da aplicacao rodando (nao mockups), reduzidas
de 1920px pra 1400px de largura e com paleta de 200 cores - ~412KB no
total, sem perda visivel de nitidez em texto/UI:

- Captura Rapida (voz, logs, imagens)
- Incidentes (lifecycle aberto/reconhecido/resolvido)
- Knowledge Base (listagem)
- Artigo de KB (gerado a partir de um incidente)
- Busca Inteligente
- Post-Mortem (templates Google SRE/Netflix/AWS)

Secao "Screenshots" adicionada logo apos os badges, antes do indice -
primeira coisa que aparece ao abrir o README.
Copilot AI review requested due to automatic review settings August 3, 2026 16:04
@janeiaraujo
janeiaraujo merged commit d350ff3 into main Aug 3, 2026
4 checks passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a “Screenshots” section to both the Portuguese and English READMEs to showcase real UI captures, improving the project’s first-impression documentation for potential users/contributors.

Changes:

  • Added a new “Screenshots” section with a 2×3 image grid (HTML table) in README.md and README.en.md.
  • Linked the new section from each README’s table of contents.
  • Referenced six screenshot assets under docs/screenshots/*.png.

Reviewed changes

Copilot reviewed 2 out of 8 changed files in this pull request and generated no comments.

File Description
README.md Adds a screenshots gallery section (PT) and TOC entry pointing to it.
README.en.md Adds the same screenshots gallery section (EN) and corresponding TOC entry.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@janeiaraujo janeiaraujo mentioned this pull request Aug 3, 2026
3 tasks
@janeiaraujo
janeiaraujo deleted the docs/add-screenshots branch August 3, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants