I’m a bit more into the hard way described by @julien because the current tutorial does bring value and insights to advanced python users (I often show it to devs with 2+ years of xp and they do learn things from it or deepen their understanding of python standard library).
Currently there are a lot of good usecases ordered in a technical fashion instead of a functional one.
You want to use a list => here’s the API and some small examples in isolation.
Which functionally could be:
You want to manipulate flowers data => Here’s how you can exploit the data with which python feature.
This is great for seasoned developers but it is not what a beginner might be looking for.
We might like to have some basic tutorials on classical use-cases in order to:
1 - Show python potential, concision and clarity
2 - Show people that they can do things and have quick satisfactory results which can be built upon.
3 - Overcome lack of confidence that you experience when you start something new
4 - Overcome modern short attention span (Introduction is nice, ease of access and working example is key)
As exposed by @maciek and @toonarmycaptain, use-cases for an easier tutorial in Python which is generalist might not be as obvious as a tutorial for a specialized library but an acceptable approach might be to have some tutorials with “popular” or “interesting” thematic like data handling (data structure, built-in library (csv), i/o api with file handling…), scientific calculus, small game (with turtle), automation, webscrapping, etc… Once they complete any of the tutorials that better fit the reason why they came learning python in the first place, they can be invited to try building their own project, use a rasberry pi, read the advanced tutorial at their pace or external resources…
About the secondary idea of @toonarmycaptain, I’m not sure to fully understand it but I would see it as an optional “advanced section” going deeper in language feature that would fall back to the tutorial (optional extensions to the tutorial that are not forks but parenthesis). The current tutorial is already quite dense and complete in my opinion !
We might also want to propose an in browser interpreter (for users struggling with python installation or just wanting to give it a quick try) like the one of pythontutor.com or even direct references to such websites.
A subtopic to consider if the idea developed in this topic is considered legitimate is how to qualify such tutorial.
Some idea that already came out while discussing the subject are:
- Getting in touch with trainers and get feedback from real test sessions.
- Providing simple feedback opportunity to users:
- Q&A/forum by chapter or paragraph with quoting option (A bit like video timestamp Q&A on learning platforms)
- End of chapter/tutorial public feedback form (difficulties, ease of use, understanding, excitement? …)