From 0ced22f6ca7b994514f78af72702da5cd38f0859 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 22 Jun 2026 02:48:16 +0000 Subject: [PATCH] fix: second pass - navigation flow, backward links, and content issues MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Navigation & flow fixes: - Add forward CTA buttons to linux/index.md, containers/index.md, automation/index.md so section indexes lead into their first page - Fix linux/introduction.md next-steps order to match nav sequence (web-hosting → advanced-hosting → troubleshooting-tools, was reversed) - Remove backward links from concepts/domains-dns.md (web-development), concepts/protocols.md (domains-dns, web-development), concepts/ssl.md (domains-dns, containers/security jump) - Reorder concepts/web-development.md next steps to match nav order (domains-dns → protocols → ssl → hosting, was hosting first) - Reorder concepts/internet-basics.md next steps to match nav order - Fix linux/web-hosting.md: remove forward-skipping links to monitoring; chain to advanced-hosting → troubleshooting-tools instead - Fix linux/advanced-hosting.md: replace unlinked "Container Orchestration" text with link to containers/index.md; remove monitoring forward-skip - Fix linux/troubleshooting-tools.md: remove backward links to earlier linux pages; point forward to containers/index.md - Fix containers/kubernetes-production.md: replace three plain-text next-step items with links to automation/index.md and advanced/index.md - Fix containers/security.md: replace unlinked "Service Mesh" text with link to advanced/index.md - Fix automation/container-cicd.md: replace two unlinked next-step items with links to monitoring and advanced/index.md Content fixes: - Fix protocols.md: replace misplaced OpenSSL code block in "Special IP Addresses" section with correct special address reference table - Fix monitoring/index.md: remove phantom mermaid nodes (Advanced Monitoring, Alerting & Response, Log Management, Observability) that reference non-existent pages - Fix introduction/index.md: remove "Metrics, Feedback (future section)" entry from Reading Path since the page does not exist - Fix introduction/practices.md: remove "(placeholder)" and "(future advanced topic placeholder)" inline labels from GitOps and Policy as Code items - Fix concepts/index.md: correct page title from "DevOps Fundamentals" to "Network & Web Fundamentals" to match nav section label - Fix docs/index.md: add Foundations as step 1 in the Learning Path; it was absent despite being the first nav section --- docs/automation/container-cicd.md | 3 +-- docs/automation/index.md | 2 ++ docs/concepts/domains-dns.md | 1 - docs/concepts/index.md | 2 +- docs/concepts/internet-basics.md | 2 +- docs/concepts/protocols.md | 20 +++++++++----------- docs/concepts/ssl.md | 3 +-- docs/concepts/web-development.md | 4 ++-- docs/containers/index.md | 2 ++ docs/containers/kubernetes-production.md | 5 ++--- docs/containers/security.md | 3 +-- docs/index.md | 16 ++++++++++------ docs/introduction/index.md | 1 - docs/introduction/practices.md | 4 ++-- docs/linux/advanced-hosting.md | 5 ++--- docs/linux/index.md | 2 ++ docs/linux/introduction.md | 6 +++--- docs/linux/troubleshooting-tools.md | 4 +--- docs/linux/web-hosting.md | 3 +-- docs/monitoring/index.md | 7 +------ 20 files changed, 44 insertions(+), 51 deletions(-) diff --git a/docs/automation/container-cicd.md b/docs/automation/container-cicd.md index c777a9e..1a0a314 100644 --- a/docs/automation/container-cicd.md +++ b/docs/automation/container-cicd.md @@ -1089,9 +1089,8 @@ spec: After implementing container CI/CD pipelines: -- Advanced Deployment Strategies (blue-green, canary deployments) -- Infrastructure as Code with Terraform and Ansible - [Monitoring and Observability](../monitoring/introduction.md) +- [Advanced & Emerging Topics](../advanced/index.md) - GitOps, progressive delivery, IaC at scale !!! tip "CI/CD Best Practices" - Implement comprehensive testing at every stage diff --git a/docs/automation/index.md b/docs/automation/index.md index ba2a6e5..64a9325 100644 --- a/docs/automation/index.md +++ b/docs/automation/index.md @@ -47,3 +47,5 @@ Automation and CI/CD are crucial for DevOps because: - **Risk Reduction**: Smaller, more frequent, less risky deployments You are now prepared to establish observability and reliability foundations. + +[Start with Automation Introduction →](introduction.md){ .md-button .md-button--primary } diff --git a/docs/concepts/domains-dns.md b/docs/concepts/domains-dns.md index 8359347..15ef51e 100644 --- a/docs/concepts/domains-dns.md +++ b/docs/concepts/domains-dns.md @@ -517,7 +517,6 @@ With domain and DNS knowledge, you're ready to: - [Internet Protocols](protocols.md) - Deep dive into HTTP, TCP/IP, and networking - [SSL Certificates](ssl.md) - Implement secure connections for your domains -- [Web Development](web-development.md) - Apply DNS concepts in application development - [Linux Server Management](../linux/introduction.md) - Configure DNS on production servers !!! tip "Practical Exercise" diff --git a/docs/concepts/index.md b/docs/concepts/index.md index dfb4560..93b4986 100644 --- a/docs/concepts/index.md +++ b/docs/concepts/index.md @@ -1,4 +1,4 @@ -# DevOps Fundamentals +# Network & Web Fundamentals Welcome to the DevOps Fundamentals section! This section covers the essential concepts and technologies that form the foundation of modern DevOps practices. diff --git a/docs/concepts/internet-basics.md b/docs/concepts/internet-basics.md index 1f5ec55..2c7f3dc 100644 --- a/docs/concepts/internet-basics.md +++ b/docs/concepts/internet-basics.md @@ -292,8 +292,8 @@ Understanding internet fundamentals positions you for roles in: Once you understand internet basics, proceed to learn about: - [Web Development Fundamentals](web-development.md) -- [Internet Protocols](protocols.md) - [Domain Names & DNS](domains-dns.md) +- [Internet Protocols](protocols.md) !!! tip "Learning Tip" Take time to understand these fundamentals - they form the foundation for everything else in DevOps! Practice with the command-line tools and try setting up a simple network lab using VirtualBox or VMware. diff --git a/docs/concepts/protocols.md b/docs/concepts/protocols.md index 23fe060..5f4d13d 100644 --- a/docs/concepts/protocols.md +++ b/docs/concepts/protocols.md @@ -98,15 +98,14 @@ graph LR #### **Special IP Addresses** - # View certificate information - openssl x509 -text -noout -in certificate.crt - - # Generate CSR - openssl req -new -key private.key -out server.csr - - # Generate self-signed certificate - openssl req -x509 -nodes -days 365 -newkey rsa:2048 \ - -keyout private.key -out certificate.crt +| Address / Range | Purpose | +|----------------|---------| +| `127.0.0.0/8` | Loopback — traffic stays on the local host (`127.0.0.1` = localhost) | +| `0.0.0.0` | Unspecified — used by hosts before they obtain an IP address | +| `255.255.255.255` | Limited broadcast — reaches all hosts on the local network segment | +| `169.254.0.0/16` | Link-local (APIPA) — auto-assigned when DHCP is unavailable | +| `100.64.0.0/10` | Carrier-grade NAT shared address space (RFC 6598) | +| `224.0.0.0/4` | Multicast — one sender, many receivers | ### IPv6 Addressing @@ -750,8 +749,7 @@ Protocol expertise is essential for: Understanding protocols enables you to: - [Configure SSL Certificates](ssl.md) - Implement secure HTTPS communications -- [Manage Domain Names & DNS](domains-dns.md) - Configure reliable name resolution -- [Web Development Fundamentals](web-development.md) - Apply protocol knowledge in applications +- [Web Hosting Concepts](hosting.md) - Explore hosting options and infrastructure - [Linux Server Management](../linux/introduction.md) - Configure and secure production servers !!! tip "Practical Exercise" diff --git a/docs/concepts/ssl.md b/docs/concepts/ssl.md index 30551f9..bfada53 100644 --- a/docs/concepts/ssl.md +++ b/docs/concepts/ssl.md @@ -94,9 +94,8 @@ timeline With SSL knowledge, you're ready to: -- [Explore Domain Management](domains-dns.md) +- [Web Hosting Concepts](hosting.md) - Explore hosting options and deployment infrastructure - [Set up Linux Servers](../linux/introduction.md) with proper SSL configuration -- [Implement Container Security](../containers/security.md) !!! info "DevOps Integration" SSL certificate management is a critical component of infrastructure automation, security compliance, and application deployment pipelines. \ No newline at end of file diff --git a/docs/concepts/web-development.md b/docs/concepts/web-development.md index 063e828..5759d7f 100644 --- a/docs/concepts/web-development.md +++ b/docs/concepts/web-development.md @@ -620,10 +620,10 @@ Once comfortable with basics, explore: After mastering web development fundamentals, proceed to: -- [Hosting Solutions](hosting.md) - Learn about different hosting options and deployment strategies +- [Domain Names & DNS](domains-dns.md) - Learn how domain resolution works - [Internet Protocols](protocols.md) - Deep dive into HTTP, TCP/IP, and other essential protocols - [SSL Certificates](ssl.md) - Understand security and encryption for web applications -- [Domain Names & DNS](domains-dns.md) - Learn how domain resolution works +- [Hosting Solutions](hosting.md) - Learn about different hosting options and deployment strategies !!! tip "Practical Exercise" **Try This**: Create a simple web application using your preferred technology stack, set up a Git repository, implement a basic CI/CD pipeline using GitHub Actions, and deploy it to a cloud platform like Netlify or Vercel. diff --git a/docs/containers/index.md b/docs/containers/index.md index 0fe0b26..26e386b 100644 --- a/docs/containers/index.md +++ b/docs/containers/index.md @@ -53,3 +53,5 @@ Containers are essential for modern DevOps because: - **Resource Efficiency**: Better resource utilization than traditional VMs Next you will apply these concepts in automation and delivery practices. + +[Start with Container Introduction →](introduction.md){ .md-button .md-button--primary } diff --git a/docs/containers/kubernetes-production.md b/docs/containers/kubernetes-production.md index 4e28418..8e9f1b7 100644 --- a/docs/containers/kubernetes-production.md +++ b/docs/containers/kubernetes-production.md @@ -1014,9 +1014,8 @@ spec: After mastering production Kubernetes deployment: -- Service Mesh Deep Dive (Istio, Linkerd) -- Multi-Cloud Kubernetes deployment -- Kubernetes Cost Optimization strategies +- [Automation & CI/CD](../automation/index.md) - next major section +- [Advanced & Emerging Topics](../advanced/index.md) - service mesh, multi-cloud, FinOps, and more !!! warning "Production Checklist" - [ ] High availability control plane diff --git a/docs/containers/security.md b/docs/containers/security.md index a46cf61..82914a8 100644 --- a/docs/containers/security.md +++ b/docs/containers/security.md @@ -902,8 +902,7 @@ podman-compose up -d After mastering container security and advanced topics: - [Kubernetes Production Deployment](kubernetes-production.md) -- [Container CI/CD Pipelines](../automation/container-cicd.md) -- Service Mesh Implementation (Istio, Linkerd) +- [Advanced Topics: Service Mesh & Beyond](../advanced/index.md) !!! warning "Security Reminders" - Never run containers as root in production diff --git a/docs/index.md b/docs/index.md index 6b218df..c5c2874 100644 --- a/docs/index.md +++ b/docs/index.md @@ -14,23 +14,27 @@ This roadmap is based on content from the [5th episode of DevOps on the Go podca This roadmap is designed to be followed sequentially for maximum benefit. Each section builds upon the previous one, creating a solid foundation for DevOps mastery. -### 1. **Fundamental Concepts** +### 1. **Foundations** -Understanding how the internet works, web development basics, and essential protocols. +What DevOps is, where it came from, the CALMS framework, core practices, and culture. -### 2. **Linux & Server Management** +### 2. **Network & Web Fundamentals** + +How the internet works, web development basics, DNS, protocols, SSL, and hosting. + +### 3. **Linux & Server Management** Master Linux systems, server administration, and hosting solutions. -### 3. **Containerization & Orchestration** +### 4. **Containerization & Orchestration** Learn Docker, Kubernetes, and modern container technologies. -### 4. **Automation & CI/CD** +### 5. **Automation & CI/CD** Implement continuous integration, delivery, and infrastructure as code. -### 5. **Monitoring & Observability** +### 6. **Monitoring & Observability** Build robust monitoring and observability solutions. diff --git a/docs/introduction/index.md b/docs/introduction/index.md index 9dab07c..8297b78 100644 --- a/docs/introduction/index.md +++ b/docs/introduction/index.md @@ -17,7 +17,6 @@ This foundational section establishes the mindset, principles, and cultural unde 3. CALMS Framework 4. Core Practices & Principles 5. Culture & Collaboration -6. Metrics, Feedback, and Continuous Improvement (future section) > As you progress, refer back here to re-anchor decisions in foundational principles rather than tools. diff --git a/docs/introduction/practices.md b/docs/introduction/practices.md index 48bf384..61cd41e 100644 --- a/docs/introduction/practices.md +++ b/docs/introduction/practices.md @@ -21,8 +21,8 @@ These practices operationalize DevOps values and create sustainable delivery per - Continuous Delivery (automated promotion, environment parity) - Infrastructure as Code & Immutable artifacts - Configuration Management + Secret Management hygiene -- GitOps for reconciliation (future advanced topic placeholder): This will include practices like declarative configurations, reconciliation loops, and tools such as Argo CD. -- Policy as Code for compliance (placeholder): This will cover automated policy enforcement using tools like OPA and Conftest, with examples for CI/CD pipelines. +- GitOps for reconciliation (declarative configurations, reconciliation loops, Argo CD) +- Policy as Code for compliance (automated policy enforcement via OPA / Conftest) ## Reliability & Resilience diff --git a/docs/linux/advanced-hosting.md b/docs/linux/advanced-hosting.md index 52dc45e..7e42d1f 100644 --- a/docs/linux/advanced-hosting.md +++ b/docs/linux/advanced-hosting.md @@ -689,9 +689,8 @@ echo "- Caching: Redis/Memcached for > 200 RPS" After implementing advanced hosting solutions: -- Container Orchestration with Kubernetes -- [Infrastructure as Code](../automation/introduction.md) -- [Advanced Monitoring](../monitoring/introduction.md) +- [Network Troubleshooting Tools](troubleshooting-tools.md) +- [Containers & Orchestration](../containers/index.md) - next major section !!! tip "Best Practices" - Always implement redundancy for critical services diff --git a/docs/linux/index.md b/docs/linux/index.md index 22fe275..307bda5 100644 --- a/docs/linux/index.md +++ b/docs/linux/index.md @@ -57,3 +57,5 @@ Linux skills are essential for DevOps because: - **Monitoring**: System monitoring and log analysis on Linux systems Proceed when you are comfortable with these Linux fundamentals. + +[Start with Linux Introduction →](introduction.md){ .md-button .md-button--primary } diff --git a/docs/linux/introduction.md b/docs/linux/introduction.md index 4dc0135..74247ff 100644 --- a/docs/linux/introduction.md +++ b/docs/linux/introduction.md @@ -155,9 +155,9 @@ Host myserver After mastering Linux basics, explore: -1. [Network Troubleshooting Tools](troubleshooting-tools.md) -2. [Self-Managed Web Hosting](web-hosting.md) -3. [Advanced Hosting Solutions](advanced-hosting.md) +1. [Self-Managed Web Hosting](web-hosting.md) +2. [Advanced Hosting Solutions](advanced-hosting.md) +3. [Network Troubleshooting Tools](troubleshooting-tools.md) ## Practical Exercises diff --git a/docs/linux/troubleshooting-tools.md b/docs/linux/troubleshooting-tools.md index e50866e..fa22b46 100644 --- a/docs/linux/troubleshooting-tools.md +++ b/docs/linux/troubleshooting-tools.md @@ -224,9 +224,7 @@ fi Master these troubleshooting tools, then move on to: -- [Self-Managed Web Hosting](web-hosting.md) -- [Advanced Hosting Solutions](advanced-hosting.md) -- [Container Networking](../containers/introduction.md) +- [Containers & Orchestration](../containers/index.md) - next major section !!! tip "Best Practices" - Always start with basic connectivity (ping) diff --git a/docs/linux/web-hosting.md b/docs/linux/web-hosting.md index a392434..ab16278 100644 --- a/docs/linux/web-hosting.md +++ b/docs/linux/web-hosting.md @@ -603,8 +603,7 @@ sudo systemctl restart apache2 After setting up self-managed hosting, explore: - [Advanced Hosting Solutions](advanced-hosting.md) -- [Container-Based Hosting](../containers/introduction.md) -- [Monitoring Web Applications](../monitoring/introduction.md) +- [Network Troubleshooting Tools](troubleshooting-tools.md) !!! warning "Production Security" - Keep all software updated with security patches diff --git a/docs/monitoring/index.md b/docs/monitoring/index.md index add4f87..495357a 100644 --- a/docs/monitoring/index.md +++ b/docs/monitoring/index.md @@ -29,12 +29,7 @@ Learn monitoring fundamentals, metrics collection, and observability principles. ```mermaid flowchart LR - A[Monitoring Introduction] --> B[Advanced Monitoring] - A --> C[Alerting & Response] - A --> D[Log Management] - B --> E[Observability] - C --> E - D --> E + A[Monitoring Introduction] --> B[Advanced & Emerging Topics] ``` ## Why This Matters