Re:Show HN: My C# Tutorial Series: Coding Basics. How am I d...
by lifebeyondfife on Thursday November 22, 2012 @08:03AM
(#4818594)
^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.
Re:Show HN: My C# Tutorial Series: Coding Basics. How am I d...
by JeremyMorgan on Thursday November 22, 2012 @05:48AM
(#4818299)
Thanks 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.
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).a...
[2] http://en.wikipedia.org/wiki/Indent_style#Allman_style
[3] http://msdn.microsoft.com/en-us/library/vstudio/ff926074.asp...