RE: A Beginners Guide to Python Programming - Part 1: If statements, Loops and Functions

[mcfarhat]

Thank you for this cool tutorial! Below is our review:hey @maticpecovnik,

• I liked the fact that you are introducing people to Python in a very simplistic and fun way, along with homeworks lol
• It's also great that you are constantly showing input and output, this helps readers follow through properly.
• Python is generally a very well documented language, and normally we're not too fond of general tutorials as such, but your personal touch is nice. There are areas where you probably jumped too quickly that the author might be lost at first, such as your use directly of z.imag
  or list1.append(list2), with the user knowing nothing about Python yet, those would appear a bit too weird to digest just yet.
• On another end, it would also be nice to come up with more innovative ways to take the user o their Python journey, avoiding standard function calls, and coming up with something cool! I saw you write STEM posts, might be awesome to combine both ;)
• Also would be great in upcoming parts of this series to provide visibility to your planned series, and links to prior parts.
  Overall, nice work !

Your contribution has been evaluated according to Utopian policies and guidelines, as well as a predefined set of questions pertaining to the category.

To view those questions and the relevant answers related to your post, click here.

---

Chat with us on Discord.
[utopian-moderator]Need help? Write a ticket on https://support.utopian.io/.

Comments

[maticpecovnik]

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.

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.

[utopian-io]

Thank you for your review, @mcfarhat! Keep up the good work!