adding descriptions to the list of examples
minor formating tweak