I like the example based approach. I learn from examples far quicker than I learn from “explanations”. If I attempt to learn from an example and my brain hits an exception, only then do I start reading the supporting text.
Nice approach. You’ve made a valuable thing and implemented a powerful idea.
I honestly wish a lot more documentations started like that with a bunch of examples. I think one I really enjoyed recently was attrs [0].
I've been using tldr [1] instead of man pages lately to get started with a command (or to remind myself how to use one). I've learned a lot just by reading the examples shown, and then read the man pages if I am missing something.