Changes to the doc examples I complained about

I only revised those two examples I complained about. If you like the way I did it I could maybe next week take a look to the others...