provisioning-outreach/presentations/pres-prvng/README_PRESENTATIONS.md

1 line
3.7 KiB
Markdown
Raw Permalink Normal View History

# Provisioning Platform - Presentation Suite\n\nComplete, production-ready presentation suite with 5 variants for different audiences.\n\n## Quick Start\n\n```bash\ncd /Users/Akasha/project-provisioning/pres-prvng\nnu run.nu\n```\n\nSelect a presentation from the menu and it will automatically:\n\n1. Copy to root directory\n2. Start Slidev development server\n3. Clean up after you exit\n\n## Presentation Variants\n\n| File | Duration | Audience | Use Case |\n|------|----------|----------|----------|\n| **pitch.md** | 10 min | Executives | Business pitch |\n| **demo-intro.md** | 15 min | Developers | Pre-demo introduction |\n| **talk.md** | 30-45 min | Technical teams | Deep technical dive |\n| **workshop.md** | 1-2 hours | Learners | Hands-on workshop |\n| **full.md** | Custom | Reference | Complete documentation |\n\nAll located in `versions/` directory for organization.\n\n## Directory Structure\n\n```plaintext\npres-prvng/\n├── run.nu # Launcher script (copy → execute → cleanup)\n├── sections/ # 8 modular slide sections\n│ ├── 01-intro.md\n│ ├── 02-solution.md\n│ ├── 03-features.md\n│ ├── 04-security.md\n│ ├── 05-usecase.md\n│ ├── 06-demos.md\n│ ├── 07-conclusion.md\n│ └── 08-appendix.md\n└── versions/ # Organized presentation variants\n ├── pitch.md\n ├── demo-intro.md\n ├── talk.md\n ├── workshop.md\n └── full.md\n```\n\n## How It Works\n\nThe `run.nu` script automatically:\n\n1. **Copies** selected presentation from `versions/` to root\n2. **Executes** `pnpm run dev` with the presentation\n3. **Cleans up** the copied file when server stops\n\nThis approach:\n\n- ✅ Keeps presentations organized in `versions/`\n- ✅ Avoids path resolution issues\n- ✅ Works reliably with all image and section references\n- ✅ Minimal technical complexity\n\n## Slide Controls\n\nWhen presentation is running:\n\n- `Arrow keys` - Navigate slides\n- `Space` - Next slide\n- `S` - Speaker notes\n- `F` - Fullscreen\n- `Ctrl+C` - Stop server (script cleans up automatically)\n\n## Features\n\n### 5 Presentation Variants\n\nEach optimized for specific audience and time constraint:\n\n- Executive pitch - Business value focus\n- Developer intro - Technical intro before live demo\n- Technical talk - Comprehensive deep dive\n- Workshop - Hands-on learning with exercises\n- Full reference - Complete documentation\n\n### Modular Architecture\n\n8 reusable sections mixed and matched across presentations:\n\n- Problem identification\n- Architecture & solution\n- Core features\n- Security & enterprise\n- Real-world use cases\n- Demonstrations\n- Getting started\n- Technical appendix\n\n### Professional Content\n\n- Clear problem statement\n- Comparative analysis (Terraform/Ansible/Provisioning)\n- Architecture diagrams & code examples\n- Security implementation details\n- Real-world use cases with ROI\n- Step-by-step deployment guide\n- Interactive exercises (workshop)\n\n## What's Included\n\n✅ 5 presentation variants (pitch, demo-intro, talk, workshop, full)\n✅ 8 modular slide sections\n✅ Automatic launcher script\n✅ Professional layout & theming\n✅ Code examples & diagrams\n✅ Logo on all presentations\n✅ No build errors or warnings\n\n## Status\n\n**✅ PRODUCTION READY**\n\nAll presentations:\n\n- Build without errors\n- Load all sections correctly\n- Display images properly\n- Handle navigation smoothly\n- Ready for consulting engagement\n\n---\n\n**Last Updated**: 2025-11-14 \n**Environment**: Slidev 52.8.0, Nushell 0.107.1+ \n**Ready for**: Consulting presentations, demos, learning sessions