12 KiB
12 KiB
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\nStructure:\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\nAudience: C-suite, non-technical decision makers, investors\nFocus: Problem → Solution → Impact\nIncludes:\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\nUse 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\nAudience: Developers, technical leads, DevOps engineers\nFocus: Why it's better + Context for live demo\nIncludes:\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\nUse 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\nAudience: Technical teams, architects, engineers\nFocus: Architecture + Features + Real-world use cases\nIncludes:\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\nUse 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\nAudience: Teams wanting hands-on training\nFocus: Learning + Practice + Mastery\nIncludes:\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\nUse 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\nFile: demos/01-server-creation-demo.sh\nShows:\n\n- Type-safe configuration\n- KCL schema validation\n- Cost estimation\n- Dry-run preview\n- Configuration impact analysis\n\nRun: bash demos/01-server-creation-demo.sh\n\n### Demo 2: Kubernetes Deployment (1 minute)\n\nFile: demos/02-kubernetes-deployment-demo.sh\nShows:\n\n- KCL schema validation\n- Automatic dependency resolution\n- Pre-flight checks\n- Parallel execution\n- Deployment planning\n\nRun: bash demos/02-kubernetes-deployment-demo.sh\n\n### Demo 3: Batch Multi-Cloud Workflow (2 minutes)\n\nFile: demos/03-batch-workflow-demo.sh\nShows:\n\n- Multi-cloud orchestration\n- Dependency graphs\n- Real-time progress monitoring\n- Task queue management\n- Audit trail\n\nRun: bash demos/03-batch-workflow-demo.sh\n\nSee: demos/README.md for detailed demo instructions\n\n## 📊 Section Organization\n\nPresentations are modular using Slidev's src: include feature.\n\nSections in sections/ folder:\n\nplaintext\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\nComposing your presentation:\n\nmarkdown\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\nbash\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\nbash\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\nBenefits:\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\nbash\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\nView presentation at: http://localhost:3030\n\n### 3. Build for Distribution\n\nbash\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\nbash\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\nbash\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\ntoml\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\nbash\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\nmarkdown\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\nbash\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\nbash\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\nbash\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\nbash\nchmod +x demos/*.sh\nbash demos/01-server-creation-demo.sh\n\n\n### Logo not showing\n\nbash\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\nIn Repository:\n\n- CLAUDE.md - Project guidelines\n- docs/ - Complete documentation\n- provisioning/ - Main codebase\n- workspace/ - Example infrastructure\n\nExternal:\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\nLast Updated: 2025-11-14\nMaintained By: Provisioning Team\nLicense: MIT\nRepository: 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\nGood luck with your presentation! 🎉