1 line
No EOL
12 KiB
Markdown
1 line
No EOL
12 KiB
Markdown
# Infrastructure Provisioning Platform - Presentation Guide\n\nComplete presentation suite for consulting, demos, and knowledge sharing.\n\n## 🎯 Quick Navigation\n\n| Audience | Duration | File | Use Case |\n|----------|----------|------|----------|\n| **Executives** | 5-10 min | `pitch.md` | C-level overview, quick pitch |\n| **Developers** | 15 min | `demo-intro.md` | Context before live demo |\n| **Technical** | 30-45 min | `talk.md` | Deep technical discussion |\n| **Learners** | 1-2 hours | `workshop.md` | Comprehensive training |\n| **Full Content** | 40 slides | `slides.md` | Master presentation |\n\n## 📋 Presentation Files\n\n### Main Presentation File: `slides.md`\n\nMaster presentation (40 slides) with modular sections\n\n**Structure:**\n\n- Imports all 8 sections via `src:` includes\n- Allows selective slide inclusion\n- Sections in `sections/` folder\n\n### Variants\n\n#### 1. **pitch.md** - Executive Overview (10 min, 12 slides)\n\n**Audience**: C-suite, non-technical decision makers, investors\n**Focus**: Problem → Solution → Impact\n**Includes**:\n\n- Problem statement (Terraform/Ansible limitations)\n- Key differentiators (3 tables/comparisons)\n- Live demo (30 sec)\n- Performance metrics\n- 20-minute getting started\n- Call to action\n\n**Use when**:\n\n- Pitching to executives\n- Time-constrained presentations\n- Focus on ROI and business value\n\n#### 2. **demo-intro.md** - Developer Introduction (15 min, 10 slides)\n\n**Audience**: Developers, technical leads, DevOps engineers\n**Focus**: Why it's better + Context for live demo\n**Includes**:\n\n- Problem identification\n- Technology stack explanation\n- Three demos overview (what you'll see)\n- Key architectural insights\n- Performance metrics\n- Question collection before demo\n\n**Use when**:\n\n- Introducing developers to the platform\n- Setting up for live demonstration\n- Building technical interest before hands-on\n\n#### 3. **talk.md** - Technical Deep Dive (30-45 min, 25 slides)\n\n**Audience**: Technical teams, architects, engineers\n**Focus**: Architecture + Features + Real-world use cases\n**Includes**:\n\n- Complete problem/solution explanation\n- Architecture decisions\n- 7 core features with code examples\n- Security deep dives\n- Real-world web/API use case\n- Performance comparisons\n- Integration strategies\n- Getting started guide\n- Q&A\n\n**Use when**:\n\n- Technical presentations\n- Conference talks\n- Technical steering committee meetings\n- Training sessions with engineering teams\n\n#### 4. **workshop.md** - Comprehensive Workshop (1-2 hours, 40 slides)\n\n**Audience**: Teams wanting hands-on training\n**Focus**: Learning + Practice + Mastery\n**Includes**:\n\n- Everything from talk.md\n- 4 hands-on exercises (20-30 min each)\n- Advanced topics:\n - CLI customization\n - Plugin development\n - KCL validation\n - CI/CD integration\n - Migration strategies\n- Troubleshooting guide\n- Performance tuning\n- Monitoring & observability\n- Best practices\n- Case studies\n- Q&A and discussion\n\n**Use when**:\n\n- Team training sessions\n- Internal skill development\n- Hands-on workshops\n- Knowledge transfer\n\n## 🎬 Demonstration Scripts\n\nThree complete, ready-to-run demonstration scripts in `demos/` folder.\n\n### Demo 1: Server Creation (30 seconds)\n\n**File**: `demos/01-server-creation-demo.sh`\n**Shows**:\n\n- Type-safe configuration\n- KCL schema validation\n- Cost estimation\n- Dry-run preview\n- Configuration impact analysis\n\n**Run**: `bash demos/01-server-creation-demo.sh`\n\n### Demo 2: Kubernetes Deployment (1 minute)\n\n**File**: `demos/02-kubernetes-deployment-demo.sh`\n**Shows**:\n\n- KCL schema validation\n- Automatic dependency resolution\n- Pre-flight checks\n- Parallel execution\n- Deployment planning\n\n**Run**: `bash demos/02-kubernetes-deployment-demo.sh`\n\n### Demo 3: Batch Multi-Cloud Workflow (2 minutes)\n\n**File**: `demos/03-batch-workflow-demo.sh`\n**Shows**:\n\n- Multi-cloud orchestration\n- Dependency graphs\n- Real-time progress monitoring\n- Task queue management\n- Audit trail\n\n**Run**: `bash demos/03-batch-workflow-demo.sh`\n\n**See**: `demos/README.md` for detailed demo instructions\n\n## 📊 Section Organization\n\nPresentations are modular using Slidev's `src:` include feature.\n\n**Sections** in `sections/` folder:\n\n```plaintext\n01-intro.md - Introduction & Problem\n02-solution.md - Solution & Architecture\n03-features.md - 7 Core Features\n04-security.md - Enterprise Security\n05-usecase.md - Real-world Use Case\n06-demos.md - Demonstration Slides\n07-conclusion.md - Getting Started & Resources\n08-appendix.md - Technical Appendices\n```\n\n**Composing your presentation**:\n\n```markdown\n---\ntheme: default\ntitle: 'Custom Presentation'\n---\n\nsrc: ./sections/01-intro.md\n---\nsrc: ./sections/02-solution.md\n---\n# Custom slides here...\n---\nsrc: ./sections/07-conclusion.md\n```\n\n## 🚀 Getting Started\n\n### 1. Setup\n\n```bash\n# Navigate to presentation directory\ncd pres-prvng\n\n# Install dependencies\nnpm install\n\n# Verify logo was copied\nls public/provisioning-logo.svg\n```\n\n### 2. Choose Your Presentation\n\n#### Option A: Using Nushell Run Scripts (Recommended)\n\n```bash\n# Interactive menu with selection\nnu run.nu\n\n# Or specify presentation directly\nnu run.nu pitch # Auto-adds .md\nnu run.nu talk\nnu run.nu demo-intro\nnu run.nu workshop\n```\n\n**Benefits**:\n\n- Interactive menu if no argument\n- Auto-validates file exists\n- Beautiful formatted output\n- Helpful launch information\n\nSee `RUN_GUIDE.md` for more details.\n\n#### Option B: Direct NPM\n\n```bash\n# Main presentation (40 slides, all sections)\nnpm run dev\n\n# Or open specific variant file\nnpm run dev pitch.md\nnpm run dev talk.md\nnpm run dev workshop.md\nnpm run dev demo-intro.md\nnpm run dev slides.md\n```\n\n**View presentation at**: <http://localhost:3030>\n\n### 3. Build for Distribution\n\n```bash\n# Build static version\nnpm run build\n\n# Output in: dist/\n\n# Serve for sharing\nnpm run serve\n```\n\n### 4. Export to PDF\n\n```bash\n# Export to PDF\nnpm run export-pdf\n\n# Creates: exports/slides.pdf\nnpm run export-pdf talk.md\n```\n\n### 5. Run Demonstrations\n\n```bash\n# Make scripts executable\nchmod +x demos/*.sh\n\n# Run one or all\nbash demos/01-server-creation-demo.sh\nbash demos/02-kubernetes-deployment-demo.sh\nbash demos/03-batch-workflow-demo.sh\n```\n\n## 📋 Presentation Checklists\n\n### Before Pitching to Executives (pitch.md)\n\n- [ ] Verify company logo can be added\n- [ ] Customize cost figures to actual pricing\n- [ ] Update timeline estimates for your infrastructure\n- [ ] Prepare quick ROI calculation\n- [ ] Have 1-page executive summary ready\n- [ ] Practice time management (10 min strict)\n\n### Before Developer Intro (demo-intro.md)\n\n- [ ] Set up terminal with large font (18pt+)\n- [ ] Test all three demo scripts\n- [ ] Familiarize with output\n- [ ] Have provisioning CLI installed (or docs for it)\n- [ ] Prepare questions slide\n- [ ] Practice transitions to live demo\n\n### Before Technical Talk (talk.md)\n\n- [ ] Know your audience (role, experience level)\n- [ ] Decide which demos to run (1 or all 3)\n- [ ] Verify code examples syntax\n- [ ] Prepare architecture diagrams if needed\n- [ ] Have fallback slides if demos fail\n- [ ] Practice pacing and transitions\n\n### Before Workshop (workshop.md)\n\n- [ ] Prepare lab environment (servers, networks)\n- [ ] Create account for each participant\n- [ ] Print exercise guides\n- [ ] Set up instructor demo setup\n- [ ] Verify all tools are installed\n- [ ] Have troubleshooting resources ready\n- [ ] Plan breaks (suggested: every 45 min)\n\n## 🎨 Customization\n\n### Update Configuration (presentation.toml)\n\n```toml\n[metadata]\ntitle = "Your Company Name - Provisioning Platform"\nauthor = "Your Name"\nsubtitle = "Tailored for your organization"\n\n[theme.colors]\nprimary = "#YOUR_BRAND_COLOR"\n```\n\n### Customize Demos\n\nEdit `demos/*.sh` to reference your infrastructure:\n\n```bash\n# Change from generic\n--infra demo\n\n# To your actual infrastructure\n--infra my-company-prod\n```\n\n### Add Your Content\n\nCreate custom slides:\n\n```markdown\n# Your Custom Slide\n\n::left::\nYour content on left\n\n::right::\nYour content on right\n```\n\nInsert into appropriate variant (talk.md, workshop.md, etc.)\n\n## 📱 Screen Sharing Tips\n\n### For Zoom/Teams/Meet\n\n1. Share screen (select presenter view)\n2. Open browser to <http://localhost:3030>\n3. Use presenter notes on second screen\n4. Navigate with arrow keys or space bar\n5. Use 'S' for speaker view\n6. Alt+Tab to terminal for demos\n\n### Terminal Setup\n\n```bash\n# Increase font size\n# Light background recommended\n# Full screen terminal\n\n# Run demo\nbash demos/01-server-creation-demo.sh\n```\n\n### Recording\n\n```bash\n# Using OBS or built-in recording\n# Start recording\n# Show slides\n# Run demos\n# Stop recording\n# Share video link\n```\n\n## 🔧 Troubleshooting\n\n### Presentation won't start\n\n```bash\nnpm install\nnpm run dev\n```\n\n### Slides look wrong\n\n- Check browser zoom (should be 100%)\n- Refresh page (Cmd+R or Ctrl+R)\n- Clear browser cache\n\n### Demo scripts not running\n\n```bash\nchmod +x demos/*.sh\nbash demos/01-server-creation-demo.sh\n```\n\n### Logo not showing\n\n```bash\n# Verify file exists\nls pres-prvng/public/provisioning-logo.svg\n\n# Check slides.md references correct path\ngrep "provisioning-logo" slides.md\n```\n\n## 📚 Additional Resources\n\n**In Repository**:\n\n- `CLAUDE.md` - Project guidelines\n- `docs/` - Complete documentation\n- `provisioning/` - Main codebase\n- `workspace/` - Example infrastructure\n\n**External**:\n\n- GitHub: <https://github.com/anthropics/provisioning>\n- Docs: <https://provisioning.io/docs>\n- Examples: <https://github.com/anthropics/provisioning/examples>\n\n## 🎓 Training Path\n\n### Beginner Path (1 hour)\n\n1. Watch pitch.md (10 min)\n2. Watch demo-intro.md (15 min)\n3. Run all 3 demos (5 min)\n4. Guide from-scratch (30 min)\n\n### Intermediate Path (2 hours)\n\n1. Watch talk.md (40 min)\n2. Run demos with explanation (10 min)\n3. Do 2 exercises from workshop.md (40 min)\n4. Hands-on: Simple server creation (30 min)\n\n### Advanced Path (3+ hours)\n\n1. Complete workshop.md (90 min)\n2. Do all 4 exercises (60 min)\n3. Try real multi-cloud deployment (60+ min)\n4. Set up monitoring and observability\n\n## 📞 Support\n\n### Questions During Presentation\n\n- Pause and answer immediately\n- Refer to relevant section\n- Note questions for Q&A section\n- Have contact info ready\n\n### Follow-up\n\n- Share slides and demo scripts\n- Provide docs links\n- Offer 1-on-1 consultation\n- Share example configurations\n\n## 📈 Metrics to Track\n\nAfter presentations, consider tracking:\n\n- Attendee count\n- Engagement level (questions asked)\n- Interest level (follow-ups)\n- Feedback scores\n- Action items generated\n- Follow-on meetings scheduled\n\nUse this to improve future presentations.\n\n## 📝 Version History\n\n| Version | Date | Changes |\n|---------|------|---------|\n| 1.0.0 | 2025-11-14 | Initial release with 4 variants + demos |\n\n---\n\n**Last Updated**: 2025-11-14\n**Maintained By**: Provisioning Team\n**License**: MIT\n**Repository**: <https://github.com/anthropics/provisioning>\n\n## 🚀 Next Steps\n\n1. **Choose your presentation variant** based on audience\n2. **Review the specific guide** for that variant\n3. **Customize as needed** for your organization\n4. **Test locally** with `npm run dev`\n5. **Practice** with demos and transitions\n6. **Present with confidence**!\n\n---\n\n**Good luck with your presentation! 🎉** |