Minor documentation tweaks.

Something I didn't change: Where it says _'they've got the control variable and an "iterator"'_ in `docs/developer_documentation/run_sections_reference.rst` should that be "iterable" not "iterator"?