Thank you very much for your input. If you dont mind I would like to respond to you bullet by bullet to explain my thinking.
- I want to emphasize user engagement in this whole guide so I introduced some fun homeworks along with some reward incentives. Hopefully people follow along.
- I find it easiest to learn a new thing by simply trying it. By showint input/output one can try this himself and see what comes out. One can then do some minor tweeks and really learn the thing in my opinion.
- I understand that this first entry is general but as my ambition is to build a "complete" guide where a user can start from the beginning I simply had to do a broad introduction. I realize it could be even more broad, as I understand that some class oriented things which are not so intuitive can be quite frustrating to understand, like the examples you pint out. By introducing some custom class programs next part I hope to elucidate on any unclear things.
- In my first post which was more of an introdcution post to the guide I talk about in which direction to take things in. I want to focus primarily on ODE solvers and stuff like that. Basically STEM subjects as you propose as that is my background.
- I really like your suggestion regarding making the outline of the guide more clear. Currently I simply planed to do things step by step, but it might be prudent to think about a more systematic pedagogical way, where the content of each part is pre-set. Sort of like a table of content even for posts not yet published.
In summary, thank you very much for your feedback. This has been my first contribution in @utopian-io and I am very happy about the positive feedback and constructive criticism I have received from you.