[WIP] re-read of http-foundation component docs

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | yes
| Applies to    | 2.1+
| Fixed tickets | #2395

Just getting started, but I wanted to submit some example commits as a WIP for early feedback. I'm also posting some questions/comments in the issue thread.