Thank you for your contribution to the open source community. It is appreciated.
I have several important ideas which could significantly affect the quality of the contribution, especially in the presentation part.
- Always remember teaching goal: While I was reading your contribution, there were times that the flow of the tutorial was heading somewhere but not the main goal.
- Approach like it's a book: Since both of them are to teach, prepare and outline your tutorial like it is a book. Write/draw a solid structure of the content, and stay loyal to the outline. And I would encourage you to provide it below the "What will I learn?" section since it does provide more information about the content.
- Avoid too long code blocks: Constantly facing long code blocks cause readers to feel lost on the page, especially when they need to check the explanation. One of the ways to deal with this problem is providing screenshots of the code in a pretty format. This is also preferable considering that the STEEM front-end platforms don't provide a good code formatting option.
- Avoid too dense content: You don't have to push all the information in just a tutorial. If you think that the reader should have a greater background to understand the rest, provide external resources or separate your content into multiple tutorials. External references always increase the quality and serve multiple options to the reader.
I hope my thoughts inspire you to improve your future tutorials. I really love to see you put effort to prepare your contributions.
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.
Need help? Write a ticket on https://support.utopian.io/.
Chat with us on Discord.
[utopian-moderator]
This is wonderful, thanks for the much effort in making a full review of tutorial, i will try my very best to correct these in my next post on the series
Hey @roj
Here's a tip for your valuable feedback! @Utopian-io loves and incentivises informative comments.
Contributing on Utopian
Learn how to contribute on our website.
Want to chat? Join us on Discord https://discord.gg/h52nFrV.
Vote for Utopian Witness!