docs: melhorar documentação para iniciantes e neurodiversidade (aprenda fazendo) #77
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Novos arquivos
GUIA_INICIANTES.md — linguagem leiga, passo-a-passo e primeiros projetos práticos.
GLOSSARIO.md — termos técnicos traduzidos para analogias simples.
ACESSIBILIDADE.md — orientações para TDAH, autismo, dislexia e daltonismo.
PROJETOS_PRATICOS.md — 6 projetos guiados (5 a 30 min).
RECURSOS_PRATICOS.md — cursos, ferramentas, templates e comunidades para aprofundar.
Arquivos revisados
CONTRIBUTING.md — reformulado para ser acolhedor para iniciantes e autodidatas.
README.md — ganhou seção “Comece por Aqui”, navegação simplificada e foco em reduzir atrito de linguagem.
🎯 Motivação das mudanças
A documentação original tinha barreira técnica elevada.
As melhorias foram feitas para:
reduzir o atrito de linguagem;
apoiar quem está começando;
facilitar aprendizado rápido com exemplos testáveis;
tornar o material acessível para pessoas neurodiversas e autodidatas.
O objetivo é manter a documentação leve, navegável e prática, sem exigir conhecimento prévio.
✔️ Checklist de validação
Exemplos testados diretamente no navegador
Linguagem simples e sem jargões desnecessários
Estrutura organizada por passos práticos
Guia de acessibilidade incluído e revisado