Revise and explain examples
Revise and explain examples

Closes #2468 after most of the work has been done by @uzluisf

tbrowder/doc,MasterDuke17/doc,tbrowder/doc,perl6/doc,MasterDuke17/doc,tbrowder/doc,MasterDuke17/doc,MasterDuke17/doc,tbrowder/doc,perl6/doc,perl6/doc,perl6/doc,perl6/doc