Skip to content

feat(atomic-design): adiciona resumo inicial sobre atomic design - #2

Open
joicenunes wants to merge 5 commits into
mainfrom
feature/atomic-design
Open

feat(atomic-design): adiciona resumo inicial sobre atomic design#2
joicenunes wants to merge 5 commits into
mainfrom
feature/atomic-design

Conversation

@joicenunes

@joicenunes joicenunes commented Aug 25, 2026

Copy link
Copy Markdown

O que este PR faz?

Adiciona seção inicial sobre Atomic Design com o intuito de exemplificar e explicar melhor os conceitos em breve

Tipo de mudança

  • Nova anotação (notes/)
  • Novo exemplo (examples/)
  • Novo exercício (examples/exercises.md)
  • Novo projeto (examples/projects.md)
  • Correção de conteúdo existente
  • Outro:

Checklist

  • O conteúdo está em português
  • Os arquivos estão no diretório correto
  • Notas novas começam com # Título na primeira linha (sem frontmatter)
  • Nova subpasta de tema foi adicionada em sidebar.json (se aplicável)
  • Links internos estão funcionando
  • Exercícios e projetos têm objetivo e critérios de sucesso descritos
  • Minha branch está atualizada com main
  • Não há conflitos de merge

Contexto adicional

@felurye felurye left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Oi! Obrigada pela colaboração. 💛

Só um ponto importante, como você criou uma pasta nova, precisa declarar ela em sidebar.json para a página ser exibida no site, e lembrando que ele ordena por ordem de declaração, então ao adicionar, veja onde faz sentido ele estar.

@felurye

felurye commented Aug 25, 2026

Copy link
Copy Markdown
Member

Racional das mudanças (commits 3fc8c86 e 32d34f9)

Por que manter a pasta atomic-design: nenhuma seção existente do repositório cobre, nem parcialmente, arquitetura de componentes de frontend (as ocorrências de "componente" nas demais notas são sobre componentes de sistema/infra, não de UI). É um tópico com escopo próprio e espaço para crescer (design tokens, composição de componentes), então justifica pasta dedicada em vez de virar uma nota solta.

Por que renomear 01-resumo-atomic-design.md para 01-atomic-design.md: o prefixo "resumo" não seguia o padrão das outras notas do repositório (01-solid.md, 01-sql.md, 01-html.md) e o conteúdo já era a explicação completa da metodologia, não um resumo.

Por que a posição na sidebar (logo após "Fundamentos Web"): Atomic Design é conteúdo de arquitetura de frontend, então entra na progressão didática logo depois de HTML/CSS e antes de "Engenharia de Software" (que hoje é focada em backend: SOLID, testes em microsserviços).

Por que expandir o conteúdo: a nota original era esquemática (bullets soltos, tabela curta, seção "Comentários" solta ao final). Adicionei prosa didática completa, diagrama Mermaid da hierarquia átomo → molécula → organismo → template → página, e exemplos de código em React para cada nível, já que os demais labs do repositório usam stack JS/TS. A seção "Comentários" foi integrada organicamente dentro das seções de Átomos, Organismos e Vantagens/Desvantagens, em vez de ficar como apêndice separado.

Por que não particionei em mais notas: o conteúdo final (~145 linhas) é comparável a outras notas do repositório sobre um único tema (ex: microsservicos/01-fundamentos-de-microsservicos.md, 128 linhas) - particionar agora criaria notas artificialmente curtas.

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