Home
Table of Contents
- 🐹 Go From Zero
- 📌 What is this?
- 🗺️ Repository Map
- 📊 Progress Snapshot
- 🧠 The Learning System
- 🚀 How to Use This Repo
- 🛠️ Tech & Tooling Covered
- 📅 The Six Months at a Glance
- 🤝 Contributing & Feedback
- 📄 License
📌 What is this?¶
This repository documents my journey learning the Go programming language from absolute zero to building production-quality backend services. It is intentionally built in public so that:
- I learn faster (teaching + retrieval practice beat passive reading),
- I leave a portfolio that demonstrates real engineering, not just tutorials, and
- other developers can learn Go alongside me by following the same path.
It is structured around a research-backed learning system (see docs/RESEARCH.md) combining Project-Based Learning, Active Recall, Spaced Repetition, the Feynman Technique, and Deliberate Practice.
🧭 New here? Start with the Roadmap, skim a cheatsheet, or read how to use this repo.
🗺️ Repository Map¶
| Path | What lives here |
|---|---|
ROADMAP.md |
The full 6-month → month → week → day learning plan |
PROGRESS.md |
Live progress: completion %, streak, hours, skill matrix, heatmap |
LEARNING_LOG.md |
One-line-per-day chronological log (the "table of contents" of my brain) |
journal/ |
Daily notes, weekly reviews, monthly reviews (the heart of the repo) |
projects/ |
Progressive projects, beginner → production capstone |
examples/ |
Small, runnable, single-concept Go programs |
exercises/ |
Practice problems with my solutions, graded by difficulty |
patterns/ |
Idiomatic Go & design patterns with runnable demos |
algorithms/ |
Data structures & algorithms implemented in Go |
interview/ |
100+ interview questions, system design, coding challenges |
cheatsheets/ |
Dense quick-reference sheets for every major topic |
patterns/ · docs/ |
Architecture docs, ADRs, and research |
docs/adr/ |
Architecture Decision Records |
templates/ |
Daily / weekly / monthly note templates |
scripts/ |
Automation (new-day generator, progress tools) |
cheatsheets/ · RESOURCES.md |
Curated learning resources |
.github/ |
CI workflows, issue/PR templates, labels |
Reference docs: RESOURCES · NOTES · FAQ · CHANGELOG · CONTRIBUTING
📊 Progress Snapshot¶
This repo tracks two different things — what's built and what I've personally studied.
📦 Repository content (authored & verified)¶
The full six-month curriculum and all projects are written and in the repo.
| Metric | Value |
|---|---|
| Curriculum authored | ✅ 6 months · 168 day notes · 24 weekly + 6 monthly reviews |
| Projects implemented | ✅ 7 / 7 (beginner → production capstone) |
| Runnable examples | 98 (stdlib-only) |
| Exercises (with tests) | 72 |
| Interview questions | 220+ across 9 files |
| Cheatsheets | 10 |
| Build status | go test — 88 root packages passing (race-clean) ✅ |
Month 1 ██████████ 100% Fundamentals (content authored)
Month 2 ██████████ 100% Stdlib, Tooling & Testing (content authored)
Month 3 ██████████ 100% Concurrency (content authored)
Month 4 ██████████ 100% Web & REST APIs + Databases (content authored)
Month 5 ██████████ 100% gRPC, Architecture & Micro. (content authored)
Month 6 ██████████ 100% Production & Capstone (content authored)
🎓 My study progress (the actual learning journey)¶
The honest day-by-day tracker — updated as I work through the material. Live detail in
PROGRESS.md.
| Metric | Value |
|---|---|
| Days studied | 1 / 168 |
| Current focus | Month 1 · Week 1 — Fundamentals |
| Current streak | 🔥 0 days |
| Study hours logged | ~1.5 h |
| Projects built myself | 0 / 7 |
🧠 The Learning System¶
This repo runs a daily loop: Read → Build → Explain → Recall → Review.
flowchart LR
A[Read<br/>docs & books] --> B[Build<br/>code & projects]
B --> C[Explain<br/>Feynman notes]
C --> D[Recall<br/>self-quiz]
D --> E[Review<br/>weekly + monthly]
E -.spaced repetition.-> A- Every day → a day note (topics, code, mistakes, questions, reflection, confidence score) + a commit.
- Every week → a weekly review (lessons, strengths, weaknesses, next-week goals).
- Every month → a monthly review + a project + a Git tag/release + a portfolio update.
See docs/RESEARCH.md for the evidence behind each choice.
🚀 How to Use This Repo¶
If you're me (the author):
- Run
./scripts/new-day.shto scaffold today's note from the template. - Follow today's plan in
ROADMAP.md. - Code in the relevant folder; write the note; self-quiz; commit with a Conventional Commit.
- At week/month boundaries, run the review templates and tag a release.
If you're a fellow learner:
- Start at
ROADMAP.mdand follow it day by day. - Use the
cheatsheets/as quick reference and theinterview/bank for retrieval practice. - Build the
projects/yourself before reading my notes — then compare. - ⭐ Star the repo to follow along; open a Discussion to ask questions.
🛠️ Tech & Tooling Covered¶
Go 1.22 · net/http · chi · gRPC · protobuf · PostgreSQL · pgx · sqlc · golang-migrate · Redis · log/slog · testify · testcontainers-go · Docker · Prometheus · OpenTelemetry · GitHub Actions · golangci-lint · pprof
📅 The Six Months at a Glance¶
| Month | Theme | Project Output | Release |
|---|---|---|---|
| 1 | Go Fundamentals | CLI Todo app | v0.1.0 |
| 2 | Stdlib, Tooling & Testing | URL shortener (tested) | v0.2.0 |
| 3 | Concurrency & Parallelism | Concurrent web crawler | v0.3.0 |
| 4 | Web, REST APIs & Databases | Bookstore REST API + Postgres | v0.4.0 |
| 5 | gRPC, Architecture & Microservices | gRPC microservice + job queue | v0.5.0 |
| 6 | Production, Observability & Capstone | Multi-tenant SaaS backend | v0.6.0 → v1.0.0 🎓 |
Full detail — objectives, weekly breakdowns, daily plans, reading, interview prep, assessments, milestones — is in ROADMAP.md. All milestones are published on the Releases page.
🤝 Contributing & Feedback¶
Spotted a mistake in my notes or have a better idiom? Please open an issue or a PR — see CONTRIBUTING.md. Corrections make this a better resource for everyone.
📄 License¶
Code and content are released under the MIT License. Learn freely.