From 6232735e7100f60de6a2416d4f4219b63af4c081 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 19 May 2026 01:48:58 +0000 Subject: [PATCH] Redesign README with hero section, visual tracks, and full course overview Full README overhaul for discoverability and first-impression impact: - Centered hero: logo, tagline, stat pills, live badge, star/fork badges - Operator loop diagram embedded in hero - "For the culture" mission statement section - Audience matrix table (5 learner profiles with value propositions) - ASCII art four-track learning map - Collapsible 31-chapter table with key skills per chapter - Time commitment table - Three quick-start options (web, local, static build) - Lesson structure breakdown (the 5 questions every lesson answers) - Capstone project summary with link - Lab safety callout - Contribute & community section with actionable next steps - Repository layout tree - Closing CTA with star/fork social badges --- README.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 249 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index d15f80b..7f997db 100644 --- a/README.md +++ b/README.md @@ -1,64 +1,281 @@ -# Learn Linux +
-A practical, open-source Linux course from The Tech Hustle for learners who want to operate real systems, not just memorize commands. +Learn Linux -![Learn Linux operator loop](docs/assets/images/operator-loop.svg) +

Learn Linux

-## What changed +

The free, open-source, operator-first Linux course โ€” built for the culture. ๐Ÿง

-This repository is now structured as a full course site powered by [MkDocs Material](https://squidfunk.github.io/mkdocs-material/). The course includes a modern landing page, searchable lesson navigation, lab setup guidance, a syllabus, glossary, capstone project, QA checklist, and repeatable build commands. +

276 lessons  ยท  31 chapters  ยท  4 learning tracks  ยท  no cost, no gatekeeping

-## Course focus +

+ + Course Site + + Lessons + Chapters + + License MIT + + + Stars + +

-Learn Linux teaches the operator loop: +
-1. Inspect the system. -2. Make the smallest safe change. -3. Verify with evidence. -4. Document the result. -5. Automate what becomes repeatable. +๐Ÿš€ Launch the Course +  ยท   +๐Ÿ“š View the Syllabus +  ยท   +๐Ÿ“– Glossary +  ยท   +๐Ÿค Contribute -The lessons cover Linux fundamentals, shell usage, packages, users, permissions, processes, filesystems, logs, networking, routing, DNS, storage, containers, CI/CD, security, monitoring, performance analysis, and operations practice. +

-## Run locally +The Linux operator learning loop: Inspect โ†’ Change โ†’ Verify โ†’ Document โ†’ Automate -```bash -python3 -m pip install -r requirements.txt -mkdocs serve +
+ +--- + +## For the culture ๐Ÿ”ฅ + +If you've been **grinding to break into tech** โ€” switching careers, self-teaching, coming up through bootcamps, or just tired of not knowing Linux on the job โ€” this course was built with you in mind. + +Linux is the foundation of the cloud, DevOps, SRE, cybersecurity, and backend engineering. It's the skill that separates people who use systems from people who **operate and own** them. + +This is not a YouTube playlist. Not a tutorial you forget in a week. This is a **complete, structured, operator-first path** from zero to production-confident โ€” free, forever, open source. + +> **The Tech Hustle** is about closing the knowledge gap. We build what should have already existed. + +--- + +## ๐ŸŽฏ Who Is This For? + +| If you are... | This course gives you... | +|---|---| +| ๐Ÿ†• **New to Linux** | A structured path from zero โ€” every concept introduced before it's used | +| ๐Ÿ–ฅ๏ธ **Help desk / support tech** | The ops skills to move into infrastructure and SRE roles | +| ๐Ÿ‘ฉโ€๐Ÿ’ป **Software engineer** | Production literacy โ€” logs, processes, networking, deployments | +| โ˜๏ธ **Cloud / DevOps / SRE learner** | Depth across storage, security, containers, CI/CD, and monitoring | +| ๐Ÿ” **Cybersecurity learner** | Linux fundamentals, access control, firewalls, SSH hardening, and auditing | + +**No prior Linux admin experience assumed.** If you can open a terminal and type, you're ready. + +--- + +## ๐Ÿง  The Operator Loop + +Every lesson trains the same five-step habit professionals use on real systems: + +``` +Inspect โ†’ Change โ†’ Verify โ†’ Document โ†’ Automate ``` -Then open `http://127.0.0.1:8000`. +You will not just run commands. You will **understand what you're looking at**, make deliberate changes, confirm the result with evidence, and document it clearly enough for a teammate to continue. That habit is what gets you hired โ€” and keeps you trusted. + +--- + +## ๐Ÿ“š What's Inside + +### Four learning tracks โ€” one continuous path + +``` +โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” +โ”‚ TRACK 1 ยท Foundations Chapters 1โ€“8 โ”‚ +โ”‚ Distributions ยท Shell ยท Filesystem ยท Processes โ”‚ +โ”‚ Packages ยท Users ยท Permissions ยท Scripting โ”‚ +โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค +โ”‚ TRACK 2 ยท Services & Infrastructure Chapters 9โ€“19 โ”‚ +โ”‚ Cloud ยท Logging ยท Kernel ยท Networking ยท Routing โ”‚ +โ”‚ DNS ยท Identity ยท Email ยท Web Hosting โ”‚ +โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค +โ”‚ TRACK 3 ยท Operations Depth Chapters 20โ€“29 โ”‚ +โ”‚ Storage ยท NFS ยท SMB ยท Config Management โ”‚ +โ”‚ Virtualization ยท Containers ยท CI/CD โ”‚ +โ”‚ Security ยท Monitoring ยท Performance โ”‚ +โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค +โ”‚ TRACK 4 ยท Professional Practice Chapters 30โ€“31 โ”‚ +โ”‚ Data Center Basics ยท Policy ยท Methodology โ”‚ +โ”‚ Documentation ยท Service Management โ”‚ +โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ +``` + +
+๐Ÿ“‹ All 31 Chapters โ€” click to expand + +
+ +| # | Chapter | Key Skills | +|---|---|---| +| 01 | Where to Start | Distributions, notation, man pages, hosting options | +| 02 | Booting & System Management | GRUB, systemd, daemons, boot recovery | +| 03 | Access Control & Rootly Powers | Permissions, sudo, ACLs, least privilege | +| 04 | Process Control | ps, top, signals, proc filesystem, cron | +| 05 | The Filesystem | File tree, mounting, pathnames, attributes | +| 06 | Software Installation | apt, dnf, package systems, FreeBSD ports | +| 07 | Scripting & the Shell | Bash, Python, Ruby, regex, Git | +| 08 | User Management | passwd, shadow, groups, PAM, centralized accounts | +| 09 | Cloud Computing | Cloud context, VPS, platform choices, cost control | +| 10 | Logging | syslog, journald, log rotation, logs at scale | +| 11 | Drivers & the Kernel | Kernel config, modules, booting, devices | +| 12 | Printing | CUPS, administration, troubleshooting | +| 13 | TCP/IP Networking | Packets, addressing, DHCP, firewalls, NAT | +| 14 | Physical Networking | Ethernet, wireless, SDN, network design | +| 15 | IP Routing | Packet forwarding, routing daemons, protocols | +| 16 | DNS | BIND, zones, security, split DNS, debugging | +| 17 | Single Sign-On | LDAP, directory login, SSO alternatives | +| 18 | Electronic Mail | SMTP, Postfix, Exim, Sendmail, spam | +| 19 | Web Hosting | Apache, Nginx, HAProxy, HTTP, cloud hosting | +| 20 | Storage | LVM, RAID, ZFS, Btrfs, partitioning, backups | +| 21 | Network File System | NFS server/client, NFSv4, automounting | +| 22 | SMB | Samba, SMB mounts, browsing, security | +| 23 | Configuration Management | Ansible, Salt, IaC best practices | +| 24 | Virtualization | VMware, VirtualBox, bhyve, Vagrant, Packer | +| 25 | Containers | Docker, Podman, clustering | +| 26 | CI/CD | Pipelines, Jenkins, container CI/CD | +| 27 | Security | SSH hardening, firewalls, VPN, cryptography | +| 28 | Monitoring | Metrics, alerting, SNMP, monitoring platforms | +| 29 | Performance Analysis | Tuning, load analysis, slow server diagnosis | +| 30 | Data Center Basics | Racks, power, cooling, reliability tiers | +| 31 | Methodology, Policy & Politics | DevOps, SLAs, ticketing, compliance, documentation | + +
+ +--- + +## โฑ๏ธ Time Commitment + +| Goal | Estimate | +|---|---| +| Single lesson | 20โ€“40 minutes | +| Full chapter | 2โ€“5 hours | +| Complete course | 80โ€“120 hours | +| Capstone project | +4โ€“8 hours | + +Move at your own pace. Skip topics you already know. Slow down and repeat labs where things feel uncertain. There are no gates. + +--- + +## โšก Quick Start -You can also use the Makefile: +**Option 1 โ€” Read on the web (no setup needed)** + +๐Ÿ‘‰ **[thetechhustle.github.io/learn_linux](https://thetechhustle.github.io/learn_linux/)** + +
+ +**Option 2 โ€” Run the course locally** ```bash +# Clone +git clone https://github.com/thetechhustle/learn_linux.git +cd learn_linux + +# Install and serve make install make serve ``` -## Build +Then open **[http://127.0.0.1:8000](http://127.0.0.1:8000)** in your browser. Full search, dark mode, and offline reading โ€” all included. + +
+ +**Option 3 โ€” Build a static copy** ```bash mkdocs build --strict +# Output goes to site/ ``` -## Repository layout +--- + +## ๐Ÿ Lesson Structure + +Every lesson answers five questions: + +1. **What is this concept?** โ€” Clear definition, no assumed knowledge +2. **Why does it matter in real operations?** โ€” The incident it prevents or the problem it solves +3. **What commands or files help you inspect it?** โ€” Read-only first, always +4. **What safe practice can you run in a lab?** โ€” Hands-on, reversible, documented +5. **How would you explain the result to a teammate?** โ€” Communication is part of the skill + +--- + +## ๐ŸŽ“ Capstone Project + +When you reach the end of the course, the [capstone](https://thetechhustle.github.io/learn_linux/course/capstone/) challenges you to: + +- Provision a VM or cloud instance from scratch +- Install and configure a small internal web service +- Set up a firewall, user accounts, and SSH hardening +- Configure logging and a basic monitoring check +- Deliberately break the service and document the recovery +- Produce a handoff document another operator can follow + +No submission. No grading. It's proof to yourself โ€” and evidence you can show anyone else. + +--- + +## ๐Ÿ› ๏ธ Lab Safety + +> Many Linux commands can change system state permanently. + +Always practice in a **VM, container, cloud sandbox, or spare machine** โ€” never on a system you care about until you understand the rollback path. The [Lab Setup guide](https://thetechhustle.github.io/learn_linux/course/lab-setup/) has everything you need to get a safe environment running in under 30 minutes. + +--- + +## ๐Ÿค Contribute & Community + +This course is open source and community-maintained. Every improvement matters. + +**Ways to contribute:** +- ๐Ÿ› [Open an issue](https://github.com/thetechhustle/learn_linux/issues) โ€” broken link, outdated command, unclear explanation +- โœ๏ธ [Submit a PR](https://github.com/thetechhustle/learn_linux/pulls) โ€” improve a lesson, add a field story, extend the glossary +- โญ [Star the repo](https://github.com/thetechhustle/learn_linux/stargazers) โ€” helps other learners find the course +- ๐Ÿ“ฃ Share it โ€” pass it to someone who needs it + +**Before contributing,** check the [QA Checklist](docs/project/qa-checklist.md) to understand how lessons are structured and validated. + +--- + +## ๐Ÿ“‚ Repository Layout ```text docs/ - index.md # Course landing page - course/ # Overview, setup, syllabus, glossary, capstone - lessons/ # Chapter and lesson Markdown - project/ # Modernization notes and QA checklist - assets/ # Course visuals -mkdocs.yml # Static course site configuration -scripts/modernize_course.py # Repeatable content cleanup/enrichment script +โ”œโ”€โ”€ index.md # Course landing page +โ”œโ”€โ”€ course/ # Overview, syllabus, glossary, lab setup, capstone +โ”œโ”€โ”€ lessons/ # 31 chapter directories, 276 lesson files +โ”œโ”€โ”€ assets/ # SVG visuals +โ””โ”€โ”€ project/ # Modernization notes, QA checklist +mkdocs.yml # Course site configuration (MkDocs Material) +Makefile # install / serve shortcuts +requirements.txt # Python dependencies ``` -## Modernization notes +--- + +## ๐Ÿ“œ License + +**MIT** โ€” Free to use, share, fork, and build on. See [LICENSE](LICENSE). + +--- + +
+ +
+ +**Built with love by [The Tech Hustle](https://github.com/thetechhustle) community.** + +*If this helped you, star it. If you know someone who needs it, share it.* +*The knowledge was always yours to have.* -See [docs/project/modernization-notes.md](docs/project/modernization-notes.md) for the concern log and implementation decisions. +
-## License +[![Star this repo](https://img.shields.io/github/stars/thetechhustle/learn_linux?style=social)](https://github.com/thetechhustle/learn_linux/stargazers) +   +[![Fork this repo](https://img.shields.io/github/forks/thetechhustle/learn_linux?style=social)](https://github.com/thetechhustle/learn_linux/fork) -MIT. See [LICENSE](LICENSE). +