Company
Date Published
Author
David Litvak
Word count
786
Language
English
Hacker News points
None

Summary

We are always looking for ways to engage and help our users understand and use Contentful in faster and better ways, so we started exploring tools for providing interactive, step-by-step tutorials in various languages, with Jupyter Notebooks being a suitable choice due to its support for data visualizations, in-browser code editing and execution, and ability to host the notebooks securely using BinderHub. We set up an example space in Contentful to facilitate our storytelling and created content types such as Person and Scatter Data to guide users through building a solution to a problem, including displaying content, rendering HTML, and showing graphs. The process of creating an interactive tutorial involves listing objectives, describing resources required, finding a theme, defining steps, writing the story, and outlining the tutorial structure, which we applied in our example using Markdown and Jupyter code snippets. We are now working on expanding and refining the project to support all Contentful's supported languages, making it easier for first-time users to get the best learning tools available.