Online Hands-on Tech Docs, the Easy Way!
summary
Open source platform Educates delivers browser-based, containerized labs that run on containers on Kubernetes and power Spring.Academy, Tanzu.Academy and Kube.Academy. Content authors get click-and-run inputs and a themed VS Code editor; sandboxes are time-boxed, resource-limited and reclaimable to prevent crypto abuse. The demo shows fast startup most of the time but occasional UI glitches; sessions can be pooled for low latency, labs declare prerequisites (databases, services) as container workloads, and content updates publish via git-backed workflows.
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!
47mCodespaces, Gitpod, Devpod what cloud and container-based IDEs can do for you
23mDocs, Demos, and Mentors: Growing Open Source
25mLeveraging Docker to Enable Learning
50mInstant Self-contained Development Environments for Everyone
06mIgnite: Reimagining Technical Training with Educates
50mInstant Self-contained Development Environments for Everyone
46mDocumentation That Runs: Bridging Code, Prose, and Interactivity