So bit of background, I am a lecturer who is currently trying to upskill with Rust, and there is one thing in the nostarch copy of the book that I believe could be a pain point for new learners.
The code examples (such as those in Chapter 2) that build on previous code from the chapter have the snipped version of the codeblocks.
The fact the online version of these codeblocks has a "show hidden code" option speaks volumes in my opinion. The need for context in these codeblocks has clearly been identified at some point for that particular option to have been added.
The struggle of trying to fit additional code from new concepts into previous examples within the chapter is something I have identified personally as a pain point that I believe other learners would likely share if learning from the nostarch copy.
As an example, the code shown in the Allowing Multiple Guesses with Looping ) section of chapter 2 is, in my opinion, quite difficult to relate to the previous code in the chapter, as seen in the nostarch version.
As a lighthearted way to prove the point, the first sentence of the paragraph directly after the snipped block, ironically, states:
As you can see, we’ve moved everything from the guess input prompt onward into a loop
I can, in fact, not see haha
Jokes aside, I propose that the codeblocks in the nostarch version of the book should include the hidden code, or some provision is devised to ensure readers can easily slot the new logic / concept into to the previous / original versions of the code examples in a chapter (maybe a set of appendices with the full codeblocks in, that then can be cross referenced at each of the main body codeblocks?)
Thank you
So bit of background, I am a lecturer who is currently trying to upskill with Rust, and there is one thing in the nostarch copy of the book that I believe could be a pain point for new learners.
The code examples (such as those in Chapter 2) that build on previous code from the chapter have the snipped version of the codeblocks.
The fact the online version of these codeblocks has a "show hidden code" option speaks volumes in my opinion. The need for context in these codeblocks has clearly been identified at some point for that particular option to have been added.
The struggle of trying to fit additional code from new concepts into previous examples within the chapter is something I have identified personally as a pain point that I believe other learners would likely share if learning from the nostarch copy.
As an example, the code shown in the Allowing Multiple Guesses with Looping ) section of chapter 2 is, in my opinion, quite difficult to relate to the previous code in the chapter, as seen in the nostarch version.
As a lighthearted way to prove the point, the first sentence of the paragraph directly after the snipped block, ironically, states:
I can, in fact, not see haha
Jokes aside, I propose that the codeblocks in the nostarch version of the book should include the hidden code, or some provision is devised to ensure readers can easily slot the new logic / concept into to the previous / original versions of the code examples in a chapter (maybe a set of appendices with the full codeblocks in, that then can be cross referenced at each of the main body codeblocks?)
Thank you