DevDocs corrections part 1

Started reviewing the developer docs, finding lots of things to correct. I'll do more later, but please review this batch first so I know what, if anything, needs to be fixed moving forward - I'm not entirely sure on the markdownish format used.
I tend to agree, this one sounds a bit confusing to me.