How k-fathi/learn-devops-tools works
1. Repository type
This is a static educational repository, not an application service. Its architecture is organized around learning modules, Markdown lessons, and Bash script examples that demonstrate Linux/DevOps concepts.
2. Top-level structure
The repo has two implemented product areas:
- 01_Learn-Linux for Linux administration content
- 02_Learn-Bash for Bash scripting content
The root README.md acts as the entrypoint/catalog and also lists future modules that are not yet implemented.
3. Linux learning subsystem
01_Learn-Linux/Admin_1 is a structured course path of numbered Markdown lessons, roughly from terminal basics through filesystem, permissions, processes, networking, SSH, logs, packages, mounting, regex, and text processing.
This module is documentation-only: it teaches operating system concepts and command usage rather than shipping executable artifacts.
4. Linux localization boundary
The Linux course is duplicated in 01_Learn-Linux/Admin_1_ar_version, which mirrors the English course in Arabic.
This is a parallel-content localization model, not runtime translation: each language version is maintained as its own set of lesson files, README, cheat sheet, and screenshots folder.
5. Bash learning subsystem
02_Learn-Bash is the more operational part of the repo. It contains:
- English_Version
- Arabic_Version
- Scripts
- images
The lesson folders provide the curriculum; the Scripts folder provides runnable examples that correspond to the topics.
6. Bash course progression
The Bash lessons are numbered from fundamentals to advanced shell programming: kernel/shell/terminal basics, variables, exit status, arithmetic, command substitution, input, conditionals, regex, case, arrays, loops, functions, source, sed, awk, and scheduling.
This forms a concept-to-practice pipeline where the text lessons explain a feature and the scripts demonstrate it.
7. Executable examples subsystem
02_Learn-Bash/Scripts/sh contains many standalone .sh files such as user management, backups, calculator, regex, file reading, monitoring, networking, cron, and text processing demos.
These scripts are not a single cohesive app; they are independent teaching examples, each usually focused on one shell concept or operational task.
8. Script input and data assets
Some scripts consume repository-local data files, such as:
- 02_Learn-Bash/Scripts/csv/users_groups.csv
- 02_Learn-Bash/Scripts/txt/cron.txt
These assets support examples like batch user/group handling or scheduling demonstrations, showing a small input-data-to-script flow inside the repo.
9. Media and illustration boundary
images and the screens folders under the Linux course hold supporting visuals and screenshots.
These assets are documentation aids only; they do not affect execution, but they are part of the learning experience and should be shown as a separate media layer in any diagram.
10. Practical runtime boundary
The only executable artifacts are the Bash scripts, and they depend on the local Linux shell environment and system tools such as user management, process inspection, networking, text processing, and scheduling utilities.
Because of that, the repo’s “runtime” is effectively the learner’s machine, not a deployable server or service.
11. Organization pattern
Across both modules, the repo uses a consistent pattern:
- numbered lesson files for curriculum order
- separate English/Arabic content trees
- cheat sheets for quick reference
- scripts/assets as hands-on supplements
This makes the architecture easy to diagram as content modules + practice assets + localization duplicates.
12. Roadmap boundary
The root README lists planned future topics like Python, Docker, Kubernetes, YAML, Ansible, Terraform, CI/CD, Nginx, Git, and Monitoring.
These are documentation commitments only at this stage and should be treated as roadmap metadata rather than current subsystems.
Main entry points: English_Version Bash English · README.md Root README · Admin_1 Linux admin · sh Shell scripts
Components 15
Catalog
Repository entrypoint and roadmap metadata
- Root README · Repository catalog and entrypoint
README.md - Future topics · Planned modules listed in the catalog
README.md
Linux course
Documentation-only Linux administration learning path
- Linux admin · English Linux administration lesson sequence
01_Learn-Linux/Admin_1 - Linux admin AR · Arabic mirror of the Linux administration lessons
01_Learn-Linux/Admin_1_ar_version - Linux cheat sheet · Quick-reference companion for the Linux course
01_Learn-Linux/Admin_1/CHEATSHEET.md
Bash course
Bash curriculum, runnable examples, and support data
- Bash English · English Bash scripting lesson sequence
02_Learn-Bash/English_Version - Bash Arabic · Arabic mirror of the Bash lessons
02_Learn-Bash/Arabic_Version - Bash cheat sheet · Quick-reference companion for the Bash course
02_Learn-Bash/English_Version/CHEATSHEET.md - Bash summary · Additional Arabic summary note for the Bash curriculum
02_Learn-Bash/Arabic_Version/bash_summary_egyptian.md - Shell scripts · Standalone runnable Bash teaching examples
02_Learn-Bash/Scripts/sh - CSV data · Repository-local data used by script examples
02_Learn-Bash/Scripts/csv/users_groups.csv - Text data · Repository-local text input used by scheduling examples
02_Learn-Bash/Scripts/txt/cron.txt
Media
Screenshots and illustrations used by lessons
- Linux screenshots · Supporting visuals for the Linux course
01_Learn-Linux/Admin_1/screens - Bash images · Illustrations and screenshots for Bash lessons
02_Learn-Bash/images
Other components
- Workspace setup · Shell and Zsh setup lessons for the learning environment
00_Workspace-Setup
Connections 16
- Root README → Workspace setup: introduces · Catalog points learners to the setup guide
- Root README → Linux admin: lists · Root catalog surfaces the Linux learning path
- Root README → Bash English: lists · Root catalog surfaces the Bash learning path
- Root README → Future topics: tracks · Planned future topics are documented in the root README
- Linux admin → Linux admin AR: mirrors · Arabic version parallels the English Linux course
- Linux admin → Linux cheat sheet: references · Linux course includes a cheat sheet companion
- Linux admin → Linux screenshots: uses · Screenshots support the Linux lessons
- Bash English → Bash Arabic: mirrors · Arabic version parallels the English Bash course
- Bash English → Bash cheat sheet: references · Bash course includes a cheat sheet companion
- Bash English → Bash summary: supplements · Arabic summary note augments the Bash material
- Bash English → Shell scripts: practices · Lessons connect to runnable shell examples
- Shell scripts → CSV data: reads · Some scripts consume CSV input data
- Shell scripts → Text data: reads · Some scripts consume text input data
- Shell scripts → Bash images: illustrated by · Bash examples are accompanied by images and visuals
- Linux admin AR → Linux screenshots: uses · Localized Linux course shares the screenshots boundary
- Bash Arabic → Bash images: uses · Localized Bash course shares the media boundary