Docs feedback, including fixed 'examples' tag to be top level (rather than nested in 'remarks')

Author: lyndon-unity