magit-process-yes-or-no-process: cosmetics

And no, I am not actually claiming that this looks better.
magit-section-{forward,backward}: improve doc-string
magit-section-show-headings: fix typo in doc-string
magit-put-face-property: return the overlay
magit-section-make-overlay: use magit-put-face-property