Some improvements on the bot tutorial

I don't know whether all this really is nice style ... but that's some of my suggestions ...