DOC: shorten example and provide clarification and spelling fix


The amount of commented text in this example wasn't particular relevant so it was cut out.