Skip to content

Commit 4829291

Browse files
author
Mujahed Altahleh
committed
Fix navigation: Create missing index pages and update navigation structure
- Created section index pages for all main categories - Updated mkdocs.yml navigation to match existing files - Fixed broken navigation links - All menu items now properly resolve to existing pages
1 parent 704067a commit 4829291

7 files changed

Lines changed: 342 additions & 24 deletions

File tree

docs/automation/index.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Automation & CI/CD
2+
3+
Welcome to the Automation & CI/CD section! This section covers continuous integration, continuous delivery, and infrastructure automation essential for modern DevOps workflows.
4+
5+
## 🎯 Learning Objectives
6+
7+
By completing this section, you will:
8+
9+
- ✅ Design and implement CI/CD pipelines
10+
- ✅ Automate container build and deployment workflows
11+
- ✅ Understand infrastructure as code principles
12+
- ✅ Master version control and branching strategies
13+
- ✅ Implement automated testing and quality gates
14+
15+
## 📚 Section Contents
16+
17+
### [Automation Introduction](introduction.md)
18+
19+
Learn CI/CD fundamentals, pipeline design, and automation best practices.
20+
21+
### [Container CI/CD](container-cicd.md)
22+
23+
Understand container-specific CI/CD patterns, registry management, and deployment strategies.
24+
25+
## 🏁 Prerequisites
26+
27+
- Completed Containers & Orchestration section
28+
- Understanding of version control (Git)
29+
- Basic scripting knowledge
30+
- Familiarity with container technologies
31+
32+
## 📈 Learning Path
33+
34+
```mermaid
35+
graph LR
36+
A[Automation Introduction] --> B[Container CI/CD]
37+
```
38+
39+
## 💡 Why This Matters
40+
41+
Automation and CI/CD are crucial for DevOps because:
42+
43+
- **Speed**: Faster delivery of features and bug fixes
44+
- **Quality**: Automated testing and quality assurance
45+
- **Reliability**: Consistent and repeatable deployments
46+
- **Collaboration**: Better developer and operations collaboration
47+
- **Risk Reduction**: Smaller, more frequent, less risky deployments
48+
49+
Let's automate everything! 🤖

docs/concepts/index.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# DevOps Fundamentals
2+
3+
Welcome to the DevOps Fundamentals section! This section covers the essential concepts and technologies that form the foundation of modern DevOps practices.
4+
5+
## 🎯 Learning Objectives
6+
7+
By completing this section, you will:
8+
9+
- ✅ Understand how the internet and web technologies work
10+
- ✅ Learn web development fundamentals and their connection to DevOps
11+
- ✅ Master domain names, DNS, and networking concepts
12+
- ✅ Understand internet protocols and their role in DevOps
13+
- ✅ Learn SSL/TLS security and encryption
14+
- ✅ Explore web hosting options and infrastructure
15+
16+
## 📚 Section Contents
17+
18+
### [Internet Basics](internet-basics.md)
19+
Learn how the internet works, including networking fundamentals, IP addresses, and routing.
20+
21+
### [Web Development Fundamentals](web-development.md)
22+
Understand web development concepts, version control, and the software development lifecycle.
23+
24+
### [Domains & DNS](domains-dns.md)
25+
Master domain name systems, DNS resolution, and domain management.
26+
27+
### [Internet Protocols](protocols.md)
28+
Deep dive into HTTP/HTTPS, TCP/UDP, SSH, and other essential protocols.
29+
30+
### [SSL/TLS Security](ssl.md)
31+
Learn about encryption, certificates, and securing web communications.
32+
33+
### [Web Hosting](hosting.md)
34+
Explore hosting options, server management, and hosting infrastructure.
35+
36+
## 🏁 Prerequisites
37+
38+
- Basic computer literacy
39+
- Curiosity about how web technologies work
40+
- No prior programming experience required
41+
42+
## 📈 Learning Path
43+
44+
```mermaid
45+
graph LR
46+
A[Internet Basics] --> B[Web Development]
47+
A --> C[Domains & DNS]
48+
A --> D[Internet Protocols]
49+
D --> E[SSL/TLS Security]
50+
B --> F[Web Hosting]
51+
C --> F
52+
E --> F
53+
```
54+
55+
## 💡 Why This Matters
56+
57+
Understanding these fundamentals is crucial for DevOps because:
58+
59+
- **Infrastructure Management**: You'll work with servers, domains, and networking
60+
- **Application Deployment**: You'll deploy web applications and services
61+
- **Security**: You'll implement SSL certificates and secure communications
62+
- **Troubleshooting**: You'll debug network and connectivity issues
63+
- **Automation**: You'll automate deployment and infrastructure tasks
64+
65+
Let's start building your DevOps foundation! 🚀

docs/containers/index.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Containers & Orchestration
2+
3+
Welcome to the Containers & Orchestration section! This section covers containerization technologies, security, and Kubernetes orchestration for modern DevOps practices.
4+
5+
## 🎯 Learning Objectives
6+
7+
By completing this section, you will:
8+
9+
- ✅ Master Docker containerization and container management
10+
- ✅ Understand container security best practices
11+
- ✅ Learn Kubernetes orchestration and production deployment
12+
- ✅ Implement container networking and storage
13+
- ✅ Design scalable container architectures
14+
15+
## 📚 Section Contents
16+
17+
### [Container Introduction](introduction.md)
18+
19+
Learn Docker fundamentals, container concepts, and containerization strategies.
20+
21+
### [Container Security](security.md)
22+
23+
Understand container security threats, vulnerability management, and security best practices.
24+
25+
### [Kubernetes Production](kubernetes-production.md)
26+
27+
Master Kubernetes deployment, management, and production-ready configurations.
28+
29+
## 🏁 Prerequisites
30+
31+
- Completed Linux & Systems section
32+
- Basic understanding of networking concepts
33+
- Familiarity with command line tools
34+
- Understanding of web applications and services
35+
36+
## 📈 Learning Path
37+
38+
```mermaid
39+
graph LR
40+
A[Container Introduction] --> B[Container Security]
41+
A --> C[Kubernetes Production]
42+
B --> C
43+
```
44+
45+
## 💡 Why This Matters
46+
47+
Containers are essential for modern DevOps because:
48+
49+
- **Portability**: Applications run consistently across environments
50+
- **Scalability**: Easy horizontal scaling and resource optimization
51+
- **Microservices**: Enable microservice architectures and service mesh
52+
- **CI/CD**: Streamlined build, test, and deployment pipelines
53+
- **Resource Efficiency**: Better resource utilization than traditional VMs
54+
55+
Let's containerize your DevOps skills! 🐳

docs/linux/index.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# Linux & Systems
2+
3+
Welcome to the Linux & Systems section! This section covers Linux fundamentals, system administration, and hosting technologies essential for DevOps professionals.
4+
5+
## 🎯 Learning Objectives
6+
7+
By completing this section, you will:
8+
9+
- ✅ Master Linux command line and system administration
10+
- ✅ Understand web server configuration and management
11+
- ✅ Learn advanced hosting and infrastructure concepts
12+
- ✅ Develop troubleshooting and debugging skills
13+
- ✅ Understand system performance and monitoring
14+
15+
## 📚 Section Contents
16+
17+
### [Linux Introduction](introduction.md)
18+
19+
Learn Linux fundamentals, command line basics, and system administration concepts.
20+
21+
### [Web Hosting](web-hosting.md)
22+
23+
Understand web server technologies, LAMP stack, and hosting management.
24+
25+
### [Advanced Hosting](advanced-hosting.md)
26+
27+
Explore advanced hosting concepts, load balancing, and scaling strategies.
28+
29+
### [Troubleshooting Tools](troubleshooting-tools.md)
30+
31+
Master debugging tools, log analysis, and system troubleshooting techniques.
32+
33+
## 🏁 Prerequisites
34+
35+
- Basic computer literacy
36+
- Completed Fundamentals section
37+
- Access to a Linux environment (VM, container, or cloud instance)
38+
39+
## 📈 Learning Path
40+
41+
```mermaid
42+
graph LR
43+
A[Linux Introduction] --> B[Web Hosting]
44+
B --> C[Advanced Hosting]
45+
A --> D[Troubleshooting Tools]
46+
C --> D
47+
```
48+
49+
## 💡 Why This Matters
50+
51+
Linux skills are essential for DevOps because:
52+
53+
- **Server Management**: Most cloud and on-premise servers run Linux
54+
- **Automation**: Shell scripting and command line automation
55+
- **Containerization**: Docker and Kubernetes run on Linux
56+
- **CI/CD**: Build agents and deployment targets are typically Linux
57+
- **Monitoring**: System monitoring and log analysis on Linux systems
58+
59+
Ready to become a Linux expert! 🐧

docs/monitoring/index.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# Monitoring & Observability
2+
3+
Welcome to the Monitoring & Observability section! This section covers monitoring systems, alerting, logging, and observability practices for DevOps environments.
4+
5+
## 🎯 Learning Objectives
6+
7+
By completing this section, you will:
8+
9+
- ✅ Design comprehensive monitoring strategies
10+
- ✅ Implement alerting and incident response workflows
11+
- ✅ Master log aggregation and analysis
12+
- ✅ Understand distributed tracing and observability
13+
- ✅ Create effective dashboards and metrics
14+
15+
## 📚 Section Contents
16+
17+
### [Monitoring Introduction](introduction.md)
18+
19+
Learn monitoring fundamentals, metrics collection, and observability principles.
20+
21+
## 🏁 Prerequisites
22+
23+
- Completed Automation & CI/CD section
24+
- Understanding of system administration
25+
- Familiarity with containerized applications
26+
- Basic knowledge of networking and protocols
27+
28+
## 📈 Learning Path
29+
30+
```mermaid
31+
graph LR
32+
A[Monitoring Introduction] --> B[Advanced Monitoring]
33+
A --> C[Alerting & Response]
34+
A --> D[Log Management]
35+
B --> E[Observability]
36+
C --> E
37+
D --> E
38+
```
39+
40+
## 💡 Why This Matters
41+
42+
Monitoring and observability are essential for DevOps because:
43+
44+
- **Reliability**: Detect and resolve issues before they impact users
45+
- **Performance**: Optimize system performance and resource utilization
46+
- **Security**: Monitor for security threats and compliance violations
47+
- **Business Intelligence**: Understand user behavior and system usage
48+
- **Continuous Improvement**: Data-driven decisions for system optimization
49+
50+
Let's make your systems observable! 📊

docs/resources/index.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Resources & References
2+
3+
Welcome to the Resources & References section! This section provides additional learning materials, tools, and references to support your DevOps journey.
4+
5+
## 🎯 Learning Objectives
6+
7+
By exploring this section, you will:
8+
9+
- ✅ Discover valuable learning resources and materials
10+
- ✅ Find recommended books, courses, and tutorials
11+
- ✅ Access useful tools and utilities
12+
- ✅ Connect with the DevOps community
13+
- ✅ Stay updated with industry trends and best practices
14+
15+
## 📚 Section Contents
16+
17+
### [Podcasts](podcast.md)
18+
19+
Discover DevOps podcasts for continuous learning and industry insights.
20+
21+
## 🏁 Additional Resources
22+
23+
- **Books**: Recommended reading list for DevOps professionals
24+
- **Courses**: Online training and certification programs
25+
- **Tools**: Essential DevOps tools and utilities
26+
- **Communities**: DevOps communities and forums
27+
- **Blogs**: Industry blogs and thought leaders
28+
29+
## 📈 Continuous Learning
30+
31+
```mermaid
32+
graph LR
33+
A[Technical Skills] --> B[Industry Knowledge]
34+
B --> C[Best Practices]
35+
C --> D[Community Engagement]
36+
D --> A
37+
```
38+
39+
## 💡 Why This Matters
40+
41+
Continuous learning is crucial for DevOps success because:
42+
43+
- **Technology Evolution**: DevOps tools and practices evolve rapidly
44+
- **Industry Trends**: Stay current with emerging patterns and methodologies
45+
- **Career Growth**: Expand your knowledge and advance your career
46+
- **Problem Solving**: Learn from others' experiences and solutions
47+
- **Innovation**: Discover new approaches and technologies
48+
49+
Keep learning and growing! 🚀

mkdocs.yml

Lines changed: 15 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -128,42 +128,33 @@ nav:
128128
- Home: index.md
129129
- Fundamentals:
130130
- concepts/index.md
131-
- DevOps Overview: concepts/overview.md
132-
- Culture & Practices: concepts/culture.md
133-
- Development Lifecycle: concepts/lifecycle.md
134-
- Linux & Basics:
131+
- Internet Basics: concepts/internet-basics.md
132+
- Web Development: concepts/web-development.md
133+
- Domains & DNS: concepts/domains-dns.md
134+
- Internet Protocols: concepts/protocols.md
135+
- SSL/TLS: concepts/ssl.md
136+
- Web Hosting: concepts/hosting.md
137+
- Linux & Systems:
135138
- linux/index.md
136139
- Linux Introduction: linux/introduction.md
137-
- Command Line: linux/command-line.md
138-
- System Administration: linux/system-admin.md
139-
- Networking: linux/networking.md
140-
- Security: linux/security.md
140+
- Web Hosting: linux/web-hosting.md
141+
- Advanced Hosting: linux/advanced-hosting.md
142+
- Troubleshooting Tools: linux/troubleshooting-tools.md
141143
- Containers & Orchestration:
142144
- containers/index.md
143145
- Container Introduction: containers/introduction.md
144-
- Advanced Docker: containers/advanced-docker.md
145-
- Kubernetes: containers/kubernetes.md
146146
- Container Security: containers/security.md
147-
- Monitoring: containers/monitoring.md
147+
- Kubernetes Production: containers/kubernetes-production.md
148148
- Automation & CI/CD:
149149
- automation/index.md
150-
- CI/CD Introduction: automation/cicd.md
151-
- Jenkins: automation/jenkins.md
152-
- GitHub Actions: automation/github-actions.md
153-
- GitLab CI: automation/gitlab-ci.md
154-
- Infrastructure as Code: automation/iac.md
150+
- Automation Introduction: automation/introduction.md
151+
- Container CI/CD: automation/container-cicd.md
155152
- Monitoring & Observability:
156153
- monitoring/index.md
157-
- Monitoring Fundamentals: monitoring/fundamentals.md
158-
- Prometheus & Grafana: monitoring/prometheus-grafana.md
159-
- Log Aggregation: monitoring/logging.md
160-
- Distributed Tracing: monitoring/tracing.md
154+
- Monitoring Introduction: monitoring/introduction.md
161155
- Resources & References:
162156
- resources/index.md
163-
- Useful Books: resources/books.md
164-
- Training Courses: resources/courses.md
165-
- Blogs & Websites: resources/blogs.md
166-
- Certifications: resources/certifications.md
157+
- Podcasts: resources/podcast.md
167158

168159
# Copyright
169160
copyright: Copyright © 2024 Mujahed Altahleh

0 commit comments

Comments
 (0)