From 9470a38dc26c1af2f84acaf3335ba4a98d2a4071 Mon Sep 17 00:00:00 2001 From: Ryanditko Date: Sat, 25 Jul 2026 14:11:07 -0300 Subject: [PATCH 1/3] docs: record v4.0.0 (rich bilingual guided-exercise briefs) Add a CHANGELOG entry documenting the enrichment of all 180 briefs to the rich template, full EN + PT-BR bilingual coverage, new templates, community-health files, GitHub tooling, CI, and the broken-link fix. Co-Authored-By: Claude Opus 4.8 --- CHANGELOG.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index e9769f5..2902b98 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,31 @@ All notable changes to this project will be documented in this file. +## [4.0.0] - 2026-07-25 + +### Major Changes + +- **Every project is now a rich guided exercise**: all 180 project briefs were rewritten from short stubs into a consistent template — Overview, Prerequisites, Learning Objectives, Functional Requirements (or Requirements & Constraints for System Design), Suggested Milestones (or Suggested Approach), Data & Interface Sketch (or Architecture Sketch), Stretch Goals, Definition of Done (or Deliverables), Common Pitfalls, and curated Resources. Briefs describe *what* to build and *why*, with illustrative sketches only — never full solution code. +- **Fully bilingual**: every brief, track landing page, and top-level document now ships in English (`README.md`) and Brazilian Portuguese (`README.pt-BR.md`), with a language switcher at the top of each. + +### Added + +- **360 project brief files**: 180 enriched English `README.md` + 180 new `README.pt-BR.md`. +- **Bilingual docs**: `README.pt-BR.md` (root) and `CONTRIBUTING.pt-BR.md`. +- **Reusable templates**: `.github/PROJECT_TEMPLATE.md` and `.github/PROJECT_TEMPLATE.pt-BR.md`. +- **Community health files**: bilingual `CODE_OF_CONDUCT.md` and `SECURITY.md`. +- **GitHub tooling**: issue forms (new project idea, content issue, enhancement) + config, `PULL_REQUEST_TEMPLATE.md`, and `CODEOWNERS`. +- **Continuous integration**: `markdown-lint` and offline `link-check` GitHub Actions workflows. + +### Fixed + +- **76 broken navigation links** across the six track READMEs (link targets now point to the real project folders). + +### Changed + +- **Root README and 6 track landing pages** rewritten with badges, tables of contents, clearer learning paths, and language switchers. +- **CONTRIBUTING** aligned with the actual repository structure and the new rich template. + ## [3.0.0] - 2026-04-05 ### Major Changes From c75b4deb95171ea7d591edab9798ed4784aba4c9 Mon Sep 17 00:00:00 2001 From: Ryanditko Date: Sat, 25 Jul 2026 14:11:08 -0300 Subject: [PATCH 2/3] ci: re-tighten structural markdown lint rules Re-enable MD022, MD032, MD040, MD047 and MD009 now that every brief has been rewritten with clean spacing. The temporary relaxation from the enrichment pass is no longer needed. Co-Authored-By: Claude Opus 4.8 --- .markdownlint.jsonc | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc index 190881a..70e86d6 100644 --- a/.markdownlint.jsonc +++ b/.markdownlint.jsonc @@ -9,14 +9,11 @@ "MD026": false, // trailing punctuation in headings "MD036": false, // emphasis used as heading — used intentionally in callouts "MD024": { "siblings_only": true }, // repeated headings ok if under different parents - "MD029": { "style": "ordered" }, + "MD029": { "style": "ordered" } - // --- Relaxed while legacy briefs are being rewritten in the enrichment pass --- - // These will be re-tightened in the final polish PR once every file has been - // regenerated with clean spacing. Tracked in the CHANGELOG / final-polish task. - "MD022": false, // blanks around headings - "MD032": false, // blanks around lists - "MD040": false, // fenced code language - "MD047": false, // single trailing newline - "MD009": false // trailing spaces + // Structural rules (MD022 blanks-around-headings, MD032 blanks-around-lists, + // MD040 fenced-code-language, MD047 single-trailing-newline, MD009 + // no-trailing-spaces) are now ENFORCED again: every brief has been rewritten + // with clean spacing, so the temporary relaxation from the enrichment pass is + // no longer needed. } From b1988c95fd3580a382822ad0c9a8b827d41dd6f3 Mon Sep 17 00:00:00 2001 From: Ryanditko Date: Sat, 25 Jul 2026 14:13:18 -0300 Subject: [PATCH 3/3] docs: normalize CHANGELOG spacing for re-tightened lint Add blank lines around lists, a language on the directory-tree fence, and a single trailing newline so the legacy CHANGELOG content passes the re-enabled structural rules. Co-Authored-By: Claude Opus 4.8 --- CHANGELOG.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2902b98..b22ea07 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -46,7 +46,7 @@ All notable changes to this project will be documented in this file. ### Added - **Main Banner Image**: `projects/images/banner-main.png` -- **Domain Banners**: +- **Domain Banners**: - `projects/images/banner-backend.png` - `projects/images/banner-frontend.png` - `projects/images/banner-data-science.png` @@ -71,7 +71,7 @@ All notable changes to this project will be documented in this file. ### New Repository Structure -``` +```text projects-library/ ├── projects/ │ ├── backend/ @@ -109,11 +109,13 @@ projects-library/ ### Renamed **Main Folders:** + - `iniciante/` → `beginner/` - `intermediario/` → `intermediate/` - `avancado/` → `advanced/` **Beginner Projects:** + - `gerador-de-senha/` → `password-generator/` - `lista-de-tarefas/` → `todo-list/` - `calculadora-simples/` → `simple-calculator/` @@ -131,6 +133,7 @@ projects-library/ - `checklist-compras/` → `shopping-checklist/` **Intermediate Projects:** + - `notas-markdown/` → `markdown-notes/` - `encurtador-url/` → `url-shortener/` - `dashboard-gastos/` → `expenses-dashboard/` @@ -143,6 +146,7 @@ projects-library/ - `gerador-relatorios-pdf/` → `pdf-report-generator/` **Advanced Projects:** + - `ecommerce-completo/` → `ecommerce-platform/` - `rede-social/` → `social-network/` - `gestao-financeira/` → `financial-management/` @@ -157,6 +161,7 @@ projects-library/ ### Project Structure Each project now contains: + - **Description**: Clear, concise project overview - **Features**: Core functionality requirements - **Learning Objectives**: Key concepts and skills to develop @@ -175,4 +180,4 @@ This repository serves as a curated collection of project ideas for developers a - Initial repository with 35 projects in Portuguese - Multi-language implementations planned (JavaScript, Python, Clojure) - Emoji-rich documentation -- Technology-specific suggestion \ No newline at end of file +- Technology-specific suggestion