Move documentation of cf_promises_validated out of introduction.

Not sure that the configuration file structure is the best place, but
it's definitely better.
Ordering of pages under introduction, and some light editing.