Reformat doco and update examples for better illustration and run time