# marcos-sa-git/aws-certifications architecture

> Architecture diagram of the GitHub repository marcos-sa-git/aws-certifications, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcos-sa-git/aws-certifications
- Repository: https://github.com/marcos-sa-git/aws-certifications

## Overview

##### Project type and purpose
- This is a static documentation repository (Markdown-based “site”) that serves as a personal portfolio and learning resource for AWS certifications (currently SAA-C03).
- It contains structured notes, hands-on labs, and translations (Spanish and English) organized under folders per certification.

##### File structure
- Top level:
- README.md (project overview, bilingual)
- SAA-C03/ (one certification folder)
- Under SAA-C03/:
- README.md (certification introduction)
- en/ (English content files)
- es/ (Spanish content files)
- No code directories or server-side components; content is pure Markdown.

##### README for additional insights
- Bilingual sections, open collaboration guidelines, markdownlint usage.
- Plans for additional certifications (SOA-C03).
- No explicit build system specified, but implies a static-site work flow.

##### Final recommendations
- Folder as a “Content Source” node, grouping SAA-C03/es and SAA-C03/en under “Certification Content.”
- Extensibility: adding new certification folders simply feeds into the same pipeline.
- This level of detail will make it straightforward for any new maintainer or auditor to understand the content lifecycle from authoring to delivery.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Actors
    Contributors["Contributors"]:::external
    Authors["Authors"]:::external
    EndUsers["End Users (Browsers)"]:::external

    %% Project Root & Collaboration
    Repo["GitHub Repo\n(README.md)"]:::content

    click Repo "https://github.com/marcos-sa-git/aws-certifications/blob/Release/README.md"

    %% Content Authoring Environment
    subgraph "Content Authoring Environment"
        direction TB
        subgraph "Certification: SAA-C03"
            direction TB
            Overview["Certification Overview\n(README.md)"]:::content
            click Overview "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/README.md"

            subgraph "English Content (en)"
                direction TB
                EN_Readme["README.md"]:::content
                click EN_Readme "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/en/README.md"
                EN_Index["Index.md"]:::content
                click EN_Index "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/en/Index.md"
            end

            subgraph "Spanish Content (es)"
                direction TB
                ES_Readme["README.md"]:::content
                click ES_Readme "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/es/README.md"
                ES_Index["Index.md"]:::content
                click ES_Index "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/es/Index.md"
                ES_Fund["1. Fundamentos.md"]:::content
                click ES_Fund "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/es/1. Fundamentos.md"
                ES_IAM["2. IAM - Identity and Access Management.md"]:::content
                click ES_IAM "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/es/2. IAM - Identity and Access Management.md"
                ES_Tips["tips.md"]:::content
                click ES_Tips "https://github.com/marcos-sa-git/aws-certifications/blob/Release/SAA-C03/es/tips.md"
            end

            Assets["Assets\n(images/diagrams)"]:::content
            click Assets "https://github.com/marcos-sa-git/aws-certifications/tree/Release/SAA-C03/assets/"
        end
    end

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline" 
        direction TB
        Lint["markdownlint & link checks"]:::ci
        Build["Static-Site Generator\n(Jekyll/Hugo/MkDocs)"]:::ci
    end

    %% Deployment & Hosting
    subgraph "Deployment & Hosting"
        direction TB
        Pages["GitHub Pages / CDN"]:::hosting
    end

    %% Connections
    Contributors -->|fork & PR| Repo
    Authors -->|clone & push| Repo
    Repo -->|on push trigger| Lint
    Lint -->|passes| Build
    Build -->|build artifacts| Pages
    Pages -->|serves| EndUsers

    %% Styles
    classDef content fill:#EEF6FF,stroke:#1E90FF
    classDef ci fill:#FFF4E5,stroke:#FFA500
    classDef hosting fill:#E6FFED,stroke:#28A745
    classDef external fill:#F2F2F2,stroke:#999999
```
