You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Improve overall tutorial structure without altering the contents of the individual topics.
My notes regarding this:
Some sections should be renamed (e.g., "conclusions"), some information should be moved around and grouped differently presenting the contents of the tutorial in a logical way.
Most of the info in Appendix shouldn't be there at all, because it's not something additional to the tutorial, it's the essential part of the tutorial. This might be a question of renaming the chapter and splitting it in a one or two other chapters.
My proposal is to have a "Learn the concepts" type of chapter: e.g. the concept of "genesis block" -- it's mentioned in lang-specific guides, but its only described in appendix and its definition is never referenced from the lang-specific guides. This might not be essential for people already familiar with blockchains but the tutorial is aiming at all kinds of audiences.
Config files better be described in something like "Configurations" section.
Address this question: do we think there are a lot of people who are interested in iroha 1 vs. iroha 2 comparison before they learn what this tutorial can offer them? My proposal is to highlight this comparison but not put it at the very beginning.
The text was updated successfully, but these errors were encountered:
My notes regarding this:
Some sections should be renamed (e.g., "conclusions"), some information should be moved around and grouped differently presenting the contents of the tutorial in a logical way.
Most of the info in Appendix shouldn't be there at all, because it's not something additional to the tutorial, it's the essential part of the tutorial. This might be a question of renaming the chapter and splitting it in a one or two other chapters.
Address this question: do we think there are a lot of people who are interested in iroha 1 vs. iroha 2 comparison before they learn what this tutorial can offer them? My proposal is to highlight this comparison but not put it at the very beginning.
The text was updated successfully, but these errors were encountered: