3 ms·
Great start Jeremy, I've read the entirety of chapter 3 and skimmed chapter 1, you have a solid foundation. However, I have a few, hopefully constructive, crit
by Denzel 14y ago
Great start Jeremy, I've read the entirety of chapter 3 and skimmed chapter 1, you have a solid foundation.
However, I have a few, hopefully constructive, critiques:
(1) As mentioned by qwerty69, links to the other chapters would help a great deal.
(2) Your target audience is "newbies"? If that's the case, it makes sense that you would provide a little more explanation for critical concepts such as variables. In chapter 3, specifically, it feels as if you gloss over the topic by deeming it a "a space to put data." Maybe you're just looking for your audience to build an intuitive notion of the concept, but annecdotally I've always enjoyed learning the essential details when tackling new topics.
(3) Speak authoritatively; don't inject fluff into your sentences. It drains mental capacity. For some examples:
"You just press that button and it will compile and run your program. Or you can just press F5 and that will do the same thing" ==> "Press that button, or F5, to compile and run your program."
"The new method Console.ReadLine() is pretty self explanatory, it reads a line of text from the console" ==> "Console.ReadLine() reads a line of text from the console."
Concise, to the point, and much more effective. I prefer reading books that explain the most in the least words possible.
Either way, keep up the good work. The more resources budding programmers have access to, the better!
- JeremyMorgan 14y ago(1)I'm likely going to put in some sort of menu system for this on the side of the articles, I haven't figured out a great way to do it yet. (2) Yes my target audiences is newbies who want a very thorough introduction. I plan on doing a whole tutorial on variables, my rough draft on types is huge, probably already bigger than this chapter was and I didn't want to crowd it up. (3) You're dead on about the fluff, I probably should have let this sit a day and came back to it to strip it out. I may even use your suggestions verbatim. Thanks!