Online Hands-on Tech Docs, the Easy Way!
summary
Demo shows an open source platform called Educates that runs on containers on Kubernetes, launches browser sandboxes with configurable resource limits and timeboxing, and supports themeable UIs, click‑to‑run steps, editors and composable terminals. It claims fast startup, offers pooled prewarmed sessions to cut wait time, and exposes sandbox definitions (databases, services) as part of lab content. It is production‑used by VMware sites and used by Spring.Academy, Tanzu.Academy and Kube.Academy.
AI-written summary · about
chapters (15)
- 0:00Introduction to hands-on docs
- 1:26Four types of tech docs
- 4:57Hands-on training benefits
- 6:45Challenges in hands-on training
- 9:36Good hands-on platform features
- 13:10Sandboxing and setup
- 15:18Time boxing and resources
- 17:42Content authoring workflows
- 20:53Scalability and cost
- 23:03Security and transparency
- 24:46Open source hands-on options
- 25:32Q&A: Hands-on vs traditional docs
- 27:16Q&A: Measuring doc performance
- 28:40Q&A: Hands-on vs IDE integration
- 31:06Closing remarks
related talks
32mOnline Hands-on Tech Docs, the Easy Way!
22mUncharted waters: Documenting emerging technology
28mCode the Docs: Interactive Document Environments
21mLuring Devs by Cutting Down the Time to First "Hello World"
30mBuilding Developer Documentation with a Fully Remote Team and Community
26mIntro to Kubernetes Docs
43mUseful and Beautiful Developer Docs and How to Create Them
29mMaking Tech Documentation Better, Easier, And Less Boring