Changes to samples.xml, adding documentation, reordering for clarity.

Cleaning up samples.xml.   Changes are done as small commits and should make this file easier for people to gather information.
Please put a blank line to separate items.