Chapter 3 feedback

[SimonDarksideJ]

Feedback related to chapter 3

[SimonDarksideJ]

Where? I know its directed to those who will have knowledge on coding but try to avoid even a second of the user questioning how, simply referencing the line of code helps subtly point the person in where to go and let them feel the tutorial is easy to follow. E.g.

You can test this yourself by modifying the code “GraphicsDevice.Clear(Color.CornflowerBlue);” to use a different color, such as Color.MonoGameOrange

You can format it to make the code line distinctive if you desire but highlighting where you are talking about specifically takes little effort and streamlines the users thought process. Try to avoid saying “do this” and assuming everyone knows what you mean because sometimes not everyone does or they are used to thinking differently on things; you are giving pointers but you are also teaching in a way and some people have difficulties reading between lines that may seem obvious to you

[AristurtleDev]

Where? I know its directed to those who will have knowledge on coding but try to avoid even a second of the user questioning how, simply referencing the line of code helps subtly point the person in where to go and let them feel the tutorial is easy to follow. E.g.

You can test this yourself by modifying the code “GraphicsDevice.Clear(Color.CornflowerBlue);” to use a different color, such as Color.MonoGameOrange

You can format it to make the code line distinctive if you desire but highlighting where you are talking about specifically takes little effort and streamlines the users thought process. Try to avoid saying “do this” and assuming everyone knows what you mean because sometimes not everyone does or they are used to thinking differently on things; you are giving pointers but you are also teaching in a way and some people have difficulties reading between lines that may seem obvious to you

Updated this section to be a note admonition with a code block showing where to make the change with the line highlighted, and also included an image of what the change would result in.