Removed the sample comments and added in the real ones

In particular a comment pointing to where there's a really good
tutorial on which some of this code is based.