[WIP] Cookbook grammar and style fixes

[frne]

This is a follow-up for #4679

It Fixes some general issues in grammar, style and readability.

(replaces #4693 which was the wrong target branch)

Q	A
Doc fix?	yes
New docs?	no
Applies to	>= 2.3
Fixed tickets

[wouterj]

To reply to:

@wouterj Agreed. Do you have a concrete idea?

Hmm, I'm not really sure what we are trying to say in this chapter. But maybe something like "For instance, if external connections come in on the default HTTP port 80" or "Imagine that external connections [...]"

@dbu I think you wrote this, can you please explain a bit more?

[dbu]

yep, i rewrote that section a few days ago. not sure what exactly is unclear. the X-Forwarded-Port needs to be set to whatever port your setup is using to receive external connections. if that would be 1234 then links will be http://example.com:1234/...

the tricky bit is that varnish may be the outmost system, or there could be something else like a load balancer or firewall that re-routes to a different port. most of the time, the external port will be 80. if you are using https, varnish does not support ssl and thus needs a proxy in front of it that terminates ssl, and then the port will almost always be 443.

does that help? happy to help more if i can, but would need a question or a proposal to comment on.

[stof]

`all files``would be even better

[wouterj]

@frne can you please fix the 2 outstanding comments?

[frne]

@wouterj Sorry. Will do it next week. I'm on holidays w/o a notebook ;)

[wouterj]

Hi @frne. do you have some time in the coming weeks/days? There will be a doc sprint day this Saturday were others can finish this PR if you want (if you want, please tell me so I can put it on the list).

[frne]

Sry. Much work these days. Will fix it next week.

[javiereguiluz]

I'm finishing this PR in #5427.

@frne don't worry about not having finished your PR. This happens sometimes. I've taken your work and finished in another PR. I've also reused all your original commits so you get the credit for your work. Thanks.

[xabbuh]

Thank you for starting this @frne.