Hey @juanma thanks for opening this discussion
From my point of view, the Learning Experience and the Learning Journey are two sides of the same coin. For me it’s easier to think about the “Journey” first, as the “Experience” is how people feel while going through the journey.
What should be for you a Good Learning Experience for Frontity?
Following my previous explanation, a good Learning Experience is the one where the developer has gone through our Learning Journey and is now able to use Frontity Framework successfully without our support (as in asking questions in the community). So from my point of view, we should try to understand how our users want to use Frontity (to create a theme from scratch, to use an existing theme, to create packages for others…) and provide them with a structured journey that covers all the concepts that they need to know in order to achieve their goals with Frontity.
What is the most critical thing that right now Frontity is not providing for having a good Learning Experience?
A unified step by step guide, that goes from the basics to the most complex concepts. So when you follow it, you end up with a project that uses all the Frontity features, and you understand the main concepts. Ideally, this step by step guide should be incremental, so if you need just the basics you can stop at the beginning, and the more you advance the more complex things you can achieve. In this regard, I feel like there’s a big gap between the Getting Started and the Learning Frontity sections of our docs.
I also think that we should create more guides explaining in detail specific use cases of Frontity. These guides could be inspired by the questions frequently asked in the community (Custom Post types, Dynamic Menus, Gutenberg, Performance/Lighthouse, CSS Libraries, WooCommerce, authentication…). Most of these topics have been covered in the Frontity Demos repo or the DevRel talks, but they aren’t easy to find for a newcomer.
Last, I find this article from Gatsby really enriching and related to this conversation, @juanma take a look at it:
If we could only explain 5 topics about Frontity, which ones would they be? (most relevant topics about Frontity)
What is Frontity Framework? What are the advantages of using it? This should also cover the advantages of using Headless, and React over a traditional WP installation
- How does Frontity compare with other similar solutions?
How to create a React theme with Frontity from scratch. This could be our step by step guide that covers everything from the basic to the most complicate concepts
- How to create, use and re-use Frontity packages
- How to deploy a Frontity project
Do you have in mind some references you can provide as an example of a good Learning Experience?
I like the NextJS learn section. I also like a lot the “Getting started with Redux by Dan Abramov”.
I feel like this thread can help us find what are the key things that we want to teach about Frontity. From my point of view, that’s the first challenge to solve. Once we have decided what we want people to learn, then we will be able to start designing the Learning Journey, and afterwards, to review the Learning Experience.