Web Dev Labs

Base de conhecimento sobre desenvolvimento web do Caramelo Tech - do HTML ao system design.

As notas deste repositório são publicadas no site do Caramelo Labs.

Conteúdo

Tópico	Descrição
Fundamentos Web	HTML e CSS
Backend	SQL, HTTP, APIs e REST
Engenharia de Software	Princípios SOLID
System Design	Consistência transacional, encurtador de URL, dual-write
Ferramentas	Git, Conventional Commits, Pull Requests, fluxos e GPG

Estrutura do repositório

web-dev-labs/
├── notes/           → Anotações em Markdown puro (publicadas no site do Caramelo Labs)
├── sidebar.json     → Seções da barra lateral no site
├── examples/        → Exemplos, exercícios e projetos práticos
└── LICENSE

Este repositório contém apenas conteúdo - não há build, dependências ou configuração de site. A estrutura web (Astro + Starlight) vive no repositório hub labs, que busca as notas daqui a cada atualização e publica o site.

Escrevendo notas

As notas em notes/ são Markdown puro, sem frontmatter:

• A primeira linha da nota deve ser o título: # Título da Nota
• Use prefixo numérico no nome do arquivo para controlar a ordem na barra lateral: 01-introducao.md, 02-conceitos.md
• Agrupe por tema em subpastas
• Imagens ficam junto das notas (ex: notes/secao/assets/img.png) e são referenciadas com caminho relativo: ![descrição](./assets/img.png)
• Links para outras notas do site usam o caminho completo: /labs/web-dev/<secao>/<nota>/

Ao criar uma nova subpasta de tema, adicione a seção correspondente em sidebar.json.

Como usar

1. Comece pelas anotações em notes/ (ou pelo site)
2. Explore os exemplos em examples/
3. Resolva os exercícios em examples/exercises.md
4. Construa os projetos em examples/projects.md

Contribuição

Contribuições são bem-vindas! Veja o Guia de Contribuição para detalhes.

Licença

MIT