# Code-First Visualizations - Presentation Agenda

Welcome! This presentation explores different approaches to creating diagrams and architecture documentation as code.

## Agenda

### 1. Introduction to Mermaid
**Native GitHub rendering, simple syntax**

[→ View Mermaid Examples](./mermaid.md)

---

### 2. PlantUML Overview
**Traditional, feature-rich diagramming**

[→ View PlantUML Examples](./plantuml.md)

**Generate Images:**
```bash
./generate_plantuml_images.sh
```
Images will be saved to `./images/plantuml/`

---

### 3. The C4 Model
**A structured approach to software architecture diagrams**

[→ Learn about C4 Model](https://c4model.com/)

---

### 4. C4 Model in Practice
**Real-world example: Royalty Accounting System**

[→ View C4 Model Example](./c4model.md)

---

### 5. Structurizr Deep Dive
**C4 model tooling and advanced features**

[→ View Structurizr Examples](./structurizr.md)

---

## Quick Reference

| Tool | GitHub Native | C4 Support | Best For |
|------|---------------|------------|----------|
| **Mermaid** | ✅ Yes | ⚠️ Manual | Quick diagrams, README files |
| **PlantUML** | ❌ No | ⚠️ Manual | Complex diagrams, all types |
| **Structurizr** | ❌ No | ✅ Native | Architecture documentation |

## Key Takeaways

1. **Mermaid** - Perfect for GitHub documentation that renders inline
2. **PlantUML** - Comprehensive diagramming with many diagram types
3. **C4 Model** - Consistent approach to architecture at different zoom levels
4. **Structurizr** - Purpose-built for C4, multiple views from one model

---

*All examples use a consistent light blue color scheme (#E6F3FF backgrounds with #1E90FF borders)*