fixed example in docs (existing example wasn't proving anything)
added docs on && short-circuiting, alongside || one
misc typos in docs