# k-fathi/learn-devops-tools architecture

> Architecture diagram of the GitHub repository k-fathi/learn-devops-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/k-fathi/learn-devops-tools
- Repository: https://github.com/k-fathi/learn-devops-tools

## Overview

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: [`02_Learn-Bash/English_Version`](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/English_Version) (Bash English), [`README.md`](https://github.com/k-fathi/learn-devops-tools/blob/main/README.md) (Root README), [`01_Learn-Linux/Admin_1`](https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1) (Linux admin), [`02_Learn-Bash/Scripts/sh`](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/Scripts/sh) (Shell scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_root["Catalog"]
  node_n_root_readme["Root README<br/>catalog<br/>[README.md]"]
  node_n_roadmap["Future topics<br/>roadmap<br/>[README.md]"]
end

subgraph group_g_linux["Linux course"]
  node_n_linux_admin_en["Linux admin<br/>curriculum"]
  node_n_linux_admin_ar["Linux admin AR<br/>localized curriculum"]
  node_n_linux_cheatsheet["Linux cheat sheet<br/>reference<br/>[CHEATSHEET.md]"]
end

subgraph group_g_bash["Bash course"]
  node_n_bash_en["Bash English<br/>curriculum"]
  node_n_bash_ar["Bash Arabic<br/>localized curriculum"]
  node_n_bash_cheatsheet["Bash cheat sheet<br/>reference<br/>[CHEATSHEET.md]"]
  node_n_bash_summary["Bash summary<br/>reference"]
  node_n_bash_scripts["Shell scripts<br/>examples"]
  node_n_bash_csv["CSV data<br/>example input<br/>[users_groups.csv]"]
  node_n_bash_txt["Text data<br/>example input<br/>[cron.txt]"]
end

subgraph group_g_media["Media"]
  node_n_linux_screens[("Linux screenshots<br/>media")]
  node_n_bash_images[("Bash images<br/>media")]
end

node_n_workspace["Workspace setup<br/>prep module"]

node_n_root_readme -->|"introduces"| node_n_workspace
node_n_root_readme -->|"lists"| node_n_linux_admin_en
node_n_root_readme -->|"lists"| node_n_bash_en
node_n_root_readme -->|"tracks"| node_n_roadmap
node_n_linux_admin_en -.->|"mirrors"| node_n_linux_admin_ar
node_n_linux_admin_en -->|"references"| node_n_linux_cheatsheet
node_n_linux_admin_en -->|"uses"| node_n_linux_screens
node_n_bash_en -.->|"mirrors"| node_n_bash_ar
node_n_bash_en -->|"references"| node_n_bash_cheatsheet
node_n_bash_en -->|"supplements"| node_n_bash_summary
node_n_bash_en -->|"practices"| node_n_bash_scripts
node_n_bash_scripts -->|"reads"| node_n_bash_csv
node_n_bash_scripts -->|"reads"| node_n_bash_txt
node_n_bash_scripts -->|"illustrated by"| node_n_bash_images
node_n_linux_admin_ar -->|"uses"| node_n_linux_screens
node_n_bash_ar -->|"uses"| node_n_bash_images

click node_n_root_readme "https://github.com/k-fathi/learn-devops-tools/blob/main/README.md"
click node_n_roadmap "https://github.com/k-fathi/learn-devops-tools/blob/main/README.md"
click node_n_workspace "https://github.com/k-fathi/learn-devops-tools/tree/main/00_Workspace-Setup"
click node_n_linux_admin_en "https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1"
click node_n_linux_admin_ar "https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1_ar_version"
click node_n_linux_cheatsheet "https://github.com/k-fathi/learn-devops-tools/blob/main/01_Learn-Linux/Admin_1/CHEATSHEET.md"
click node_n_linux_screens "https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1/screens"
click node_n_bash_en "https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/English_Version"
click node_n_bash_ar "https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/Arabic_Version"
click node_n_bash_cheatsheet "https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/English_Version/CHEATSHEET.md"
click node_n_bash_summary "https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Arabic_Version/bash_summary_egyptian.md"
click node_n_bash_scripts "https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/Scripts/sh"
click node_n_bash_csv "https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Scripts/csv/users_groups.csv"
click node_n_bash_txt "https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Scripts/txt/cron.txt"
click node_n_bash_images "https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/images"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_n_root_readme,node_n_roadmap toneBlue
class node_n_linux_admin_en,node_n_linux_admin_ar,node_n_linux_cheatsheet toneAmber
class node_n_bash_en,node_n_bash_ar,node_n_bash_cheatsheet,node_n_bash_summary,node_n_bash_scripts,node_n_bash_csv,node_n_bash_txt toneMint
class node_n_linux_screens,node_n_bash_images toneRose
class node_n_workspace toneNeutral
```

## Components

### Catalog

Repository entrypoint and roadmap metadata

- [Root README](https://github.com/k-fathi/learn-devops-tools/blob/main/README.md): catalog · Repository catalog and entrypoint · `README.md`
- [Future topics](https://github.com/k-fathi/learn-devops-tools/blob/main/README.md): roadmap · Planned modules listed in the catalog · `README.md`

### Linux course

Documentation-only Linux administration learning path

- [Linux admin](https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1): curriculum · English Linux administration lesson sequence · `01_Learn-Linux/Admin_1`
- [Linux admin AR](https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1_ar_version): localized curriculum · Arabic mirror of the Linux administration lessons · `01_Learn-Linux/Admin_1_ar_version`
- [Linux cheat sheet](https://github.com/k-fathi/learn-devops-tools/blob/main/01_Learn-Linux/Admin_1/CHEATSHEET.md): reference · 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](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/English_Version): curriculum · English Bash scripting lesson sequence · `02_Learn-Bash/English_Version`
- [Bash Arabic](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/Arabic_Version): localized curriculum · Arabic mirror of the Bash lessons · `02_Learn-Bash/Arabic_Version`
- [Bash cheat sheet](https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/English_Version/CHEATSHEET.md): reference · Quick-reference companion for the Bash course · `02_Learn-Bash/English_Version/CHEATSHEET.md`
- [Bash summary](https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Arabic_Version/bash_summary_egyptian.md): reference · Additional Arabic summary note for the Bash curriculum · `02_Learn-Bash/Arabic_Version/bash_summary_egyptian.md`
- [Shell scripts](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/Scripts/sh): examples · Standalone runnable Bash teaching examples · `02_Learn-Bash/Scripts/sh`
- [CSV data](https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Scripts/csv/users_groups.csv): example input · Repository-local data used by script examples · `02_Learn-Bash/Scripts/csv/users_groups.csv`
- [Text data](https://github.com/k-fathi/learn-devops-tools/blob/main/02_Learn-Bash/Scripts/txt/cron.txt): example input · Repository-local text input used by scheduling examples · `02_Learn-Bash/Scripts/txt/cron.txt`

### Media

Screenshots and illustrations used by lessons

- [Linux screenshots](https://github.com/k-fathi/learn-devops-tools/tree/main/01_Learn-Linux/Admin_1/screens): media · Supporting visuals for the Linux course · `01_Learn-Linux/Admin_1/screens`
- [Bash images](https://github.com/k-fathi/learn-devops-tools/tree/main/02_Learn-Bash/images): media · Illustrations and screenshots for Bash lessons · `02_Learn-Bash/images`

### Other components

- [Workspace setup](https://github.com/k-fathi/learn-devops-tools/tree/main/00_Workspace-Setup): prep module · Shell and Zsh setup lessons for the learning environment · `00_Workspace-Setup`

## Connections

- 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
