fix(doc) more sensible ordering

It makes a bit more sense to specify the scope of the section
before getting into details about how it's done.