3 ms·
One thing that jumped out at me right away is your indentation style which is a wee bit messy. New programmers need to be taught good/consistent coding style in
by teh_klev 14y ago
One thing that jumped out at me right away is your indentation style which is a wee bit messy. New programmers need to be taught good/consistent coding style in the early stages of their development as well as how to use the language. Your examples should reflect what are generally accepted, though not mandatory, conventions.
The first thing I do if I'm coaching/mentoring a C#/.NET novice is to get them to follow the C# Coding Conventions [1] with Allman style indentation [2] and the Design Guidelines for Developing Class Libraries [3].
One other thing I would do is liberally sprinkle the tutorial with links to relevant further reading in the MSDN docs. A lot of new devs are overwhelmed by the MSDN library and often have no idea where to begin looking for reference material. Giving them good entry points so they can familiarise themselves with the official docs would be a beneficial addition.
[1] http://msdn.microsoft.com/en-us/library/ms229042(v=vs.100).aspx http://msdn.microsoft.com/en-us/library/ms229042(v=vs.100).a...
[2] http://en.wikipedia.org/wiki/Indent_style#Allman_style http://en.wikipedia.org/wiki/Indent_style#Allman_style
[3] http://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx http://msdn.microsoft.com/en-us/library/vstudio/ff926074.asp...
- JeremyMorgan 14y agoThanks for the feedback. I'll make a note of that as the style I present the samples in, since this is tutorial for beginners the last thing I want to do is spread my bad habits.
- lifebeyondfife 14y ago^this There's bad indentation e.g. a for block not indented, and a mixture of C and Java style indentation. I recommend following the standard Microsoft style indentation which is place the opening brace on a new line on its own. Also, "it will compile and run, then ask the user to press a key go back". One missing 'to' doesn't seem so bad but the accumulation of these little details really adds up. Really nice though, I like taking the user back to the console and command line and walking them through everything. Best of luck.