Samples Documentation

Some quick documentation on samples. Recent pull requests are kind of all
over the place so let's put down some ground rules.