How josejesusguzman/acordeon-az900-innovaccion works
1. Repository role
- This is not an application codebase; it is a static study/content repository for the AZ-900 Microsoft Fundamentals certification, curated for Innovacción Virtual.
- The repository’s main output is documentation and learning materials rather than a runtime service.
2. Publishing model
- The presence of _config.yml strongly suggests the content is intended for GitHub Pages / Jekyll-style static publishing.
- The README acts as the landing page and learning hub, while the markdown and media files under res/ provide the supporting pages/assets.
3. Top-level structure
- README.md: primary entry point; describes the study method, weekly learning path, links, and contributor info.
- res/: the main content library.
- .gitignore: standard repository hygiene.
- _config.yml: site configuration for static site generation/publishing.
4. Learning-path subsystem
- The README is organized into weeks and modules:
- Week 1: Azure fundamentals and core concepts
- Week 2: compute, networking, storage, databases
- Week 3: administration, AI/ML, IoT, serverless, monitoring
- Week 4: security, identity, governance, privacy, compliance
- Week 4 also includes SLA and cost management
- This structure is the core navigation model of the repo.
5. Reference-content subsystem
- Under res/, the repo contains many self-contained markdown guides/comparisons:
- Azure terminology and glossary files
- Service comparisons such as compute, networking, security, Azure AD, Cognitive Services, Sentinel/Sphere, Advisor/Monitor/Log Analytics/Service Health
- Governance and compliance notes
- Cloud adoption framework steps
- These files act as the “knowledge base” behind the study path.
6. Hands-on lab subsystem
- Several resources point to practical exercises, such as:
- SQL queries for Azure SQL Database
- ARM template creation
- SLA calculations
- Machine Learning Studio exercise
- Kubernetes / WordPress tutorials
- Some labs are embedded in this repo as markdown; others link out to external GitHub repositories or videos.
7. Media and asset subsystem
- res/images/ contains visual learning assets, including concept diagrams and tutorial-specific images.
- res/docs/ contains downloadable office/PDF assets such as:
- glossary PDFs
- a business outcome template spreadsheet
- a Cloud Adoption Framework strategy template
- These assets support the textual study materials and are part of the static content boundary.
8. External service boundary
- The repo heavily depends on external learning and tooling platforms rather than internal services:
- Microsoft Learn challenge modules
- Azure pricing calculator and TCO calculator
- Azure SLA pages
- Spotify playlists/podcasts
- Miro boards
- Microsoft Stream recordings
- GitHub-hosted companion labs
- Azure sponsorship portal and mobile Azure apps
- The repository is therefore a curated navigation layer over external content.
9. Azure domain coverage
- The content maps directly to AZ-900 domains:
- cloud concepts
- core Azure services
- solutions/management tools
- security and networking
- identity/governance/privacy/compliance
- cost management and SLAs
- This makes the repo a certification-focused knowledge graph rather than a general documentation site.
10. Contribution workflow
- The README explicitly invites users to contribute through pull requests and issues for content additions or corrections.
- A concrete example is the playlist contribution flow via res/adiciones-playlist.md.
- This indicates a community-maintained content repository with editorial review, not an automated software pipeline.
11. Important architectural boundary
- There is no application backend, database, or API layer in this repository.
- The main system boundary is between:
- static curated content in the repo
- and external interactive resources/labs/platforms the learners use alongside it.
12. How to diagram it
- A correct architecture diagram would show:
- one static content repository/site at the center
- grouped content domains under it: weeks/modules, glossary, comparisons, labs, media/docs
- multiple outbound links to Microsoft Learn and other external tools
- contribution input from the community via PRs/issues
- The repo’s purpose is to organize and publish study assets, not to execute application logic.
Main entry points: res Content library · README.md Weekly path · _config.yml Jekyll config · terminos_azure.md Glossary
Components 22
Repository
Static publishing and entry points
- README · Primary study hub and navigation for the certification path
README.md - Jekyll config · Static publishing configuration for GitHub Pages/Jekyll
_config.yml - Contrib workflow · Issue and pull-request driven content updates
README.md
Study Content
Learning path, guides, and exercises
- Content library · Main knowledge base of curated AZ-900 study materials
res - Weekly path · Week-by-week structure covering AZ-900 domains
README.md - Azure basics · Cloud concepts and core Azure foundation topics
README.md - Core services · Compute, networking, storage, and database coverage
README.md - Mgmt tools · Administration, monitoring, AI/ML, IoT, and serverless topics
README.md - Security & gov · Identity, security, governance, privacy, compliance, cost, and SLA topics
README.md - Comparisons · Service comparison guides for Azure decision-making
res - Glossary · Terminology and definitions for AZ-900 study
res/terminos_azure.md - Hands-on labs · Practical exercises and tutorials embedded in markdown
res - SLA & cost · Service level, pricing, and cost-management exercises
res - Governance notes · Compliance and cloud adoption framework guidance
res
Assets
Documents and images supporting study materials
External Platforms
Outbound learning and tooling destinations
- MS Learn · Challenge modules and official learning content
- Calculators · Pricing and TCO calculators used in study material
- Azure SLA · Official SLA pages for service availability study
- Companion labs · GitHub-hosted lab repositories and exercises
- Media tools · Playlists, podcasts, boards, and recordings supporting learning
- Azure apps · Azure portal and mobile app resources referenced by the repo
Connections 24
- Jekyll config → Content library: publishes · Configures static site publishing for the study content
- README → Weekly path: organizes · README structures the week-by-week curriculum
- Weekly path → Azure basics: week 1 · Cloud fundamentals and Azure concepts
- Weekly path → Core services: week 2 · Core services and infrastructure topics
- Weekly path → Mgmt tools: week 3 · Management, AI/ML, IoT, and automation topics
- Weekly path → Security & gov: week 4 · Security, governance, compliance, and cost topics
- Content library → Comparisons: contains · Comparison guides across major Azure services
- Content library → Glossary: contains · Terminology and definition references
- Content library → Hands-on labs: contains · Practical exercises and tutorial markdown
- Content library → SLA & cost: contains · SLA and cost-management study resources
- Content library → Governance notes: contains · Compliance and adoption framework notes
- Content library → Images: supports · Visual learning assets for diagrams and tutorials
- Content library → Documents: supports · Downloadable PDFs, spreadsheets, and templates
- Comparisons → Azure basics: covers · Comparison guides reinforce core Azure concepts
- Comparisons → Core services: covers · Service comparisons for compute, networking, storage, and security
- Hands-on labs → Companion labs: links to · Some exercises point to external companion repositories
- Hands-on labs → MS Learn: references · Exercises and challenges use official learning modules
- SLA & cost → Calculators: uses · Pricing and TCO calculators support cost studies
- SLA & cost → Azure SLA: uses · Official SLA pages back availability exercises
- Governance notes → MS Learn: references · Governance and adoption content aligns to Microsoft guidance
- Contrib workflow → Content library: updates · Pull requests and issues contribute corrections and additions
- README → Contrib workflow: invites · README documents the contribution workflow
- README → Media tools: references · Curated playlists, boards, and recordings supplement study
- README → Azure apps: references · Mentions Azure portal and mobile app resources