Full Stack Documentation – Rich Harris, JSNation 2022

"Learn about the power of interactive tutorials and full-stack documentation, as Rich Harris shares insights on how to effectively teach developers and provide a safe learning environment, using SvelteKit as a prime example."

Key takeaways
  • Documentation is not just a reference manual, but a series of concepts that include tutorials, how-tos, and explanatory material.
  • Interactive tutorials are more effective than passive reference documents in teaching people how to use a tool or framework.
  • The Morpheus Principle states that safety comes first, which is why interactive tutorials are designed to provide a safe learning environment.
  • The benefits of interactive tutorials include repetition, which is how people learn, and the ability to make mistakes and learn from them.
  • Full-stack documentation refers to documentation that covers the entire development process, from front-end to back-end.
  • Rich Harris emphasizes the importance of learning and application, emphasizing that learning and application are opposite ends of a single axis.
  • Tools like CodeSandbox, Glitch, and Gitpod allow developers to create and share their own tutorials and projects, making learning more accessible.
  • SvelteKit is a full-stack framework that allows for dynamic server-side rendering and relies on Node.js.
  • The technology behind SvelteKit is called web containers, which allows for fast development and deployment.