Polishing some docs

Prompted by someone who had some trouble creating an extension, I've simplified and polished the docs for that a bit.