docs: Proofreading + general improvements

[kvanzuijlen]

Changes

I did some proofreading and some miscellaneous improvements (IMO)

Context

I noticed some typos in the docs, so I decided to have a better look at all the files.

Documentation (please check one with an [x])

• I have updated the documentation, or
• No documentation update is required

How I've tested my work (please select one)

I have verified these changes via:

• Code inspection only, or
• Newly added/modified unit tests, or
• No unit tests but ran on a real repository, or
• Both unit tests + ran on a real repository

[HonkingGoose]

I actually like most of your changes, even though I'm suggesting a lot of changes... 🙃

Please go to the Files changed tab on GitHub, and batch my suggestions. Do not apply my suggestions one by one!

Read the GitHub Docs, to learn how to batch apply suggestions.

Please also make sure to revert the ordered lists to this format:

1. First item
1. Second item
1. Third item
1. And so on

[HonkingGoose]

Also, please do not force push to this branch. We squash-merge later, so the PR title becomes the final commit message.

[kvanzuijlen]

Thanks for the in-depth review @HonkingGoose! Some really good points that were great improvements on lines I only checked for grammar, thanks!

[kvanzuijlen]

@HonkingGoose I updated all lists to follow the styling guide as added by you in #26445. I also reverted the quotes I edited by mistake.

[kvanzuijlen]

Merge-conflict resolved due to an overlapping change in #26478

[kvanzuijlen]

@HonkingGoose Can you resolve the conversations that are done/resolved? Might be easier to read for the maintainers that way.

[HonkingGoose]

@kvanzuijlen I don't have write rights to this repository. So only the maintainers can resolve discussions. 🙂

[viceice]

@kvanzuijlen you can resolve discussions yourself when they are done

[kvanzuijlen]

Completely overlooked that, as well as the fact that there were some more comments... Thanks!

[astellingwerf]

Goedemiddag @kvanzuijlen. I see you collapsed a considerable amount of "you are", "they will", and "do not" into "you're", "they'll", and "don't" respectively. Why was that? Renovate aims for a wide audience with a diverse level of proficiency in English. The explicit version may be more accessible.

[kvanzuijlen]

Goedemiddag @kvanzuijlen. I see you collapsed a considerable amount of "you are", "they will", and "do not" into "you're", "they'll", and "don't" respectively. Why was that? Renovate aims for a wide audience with a diverse level of proficiency in English. The explicit version may be more accessible.

It makes it easier to read for me personally (sounds more natural), but I can see the other side of things as well, so I'm fine if it should be reverted as well.

[rarkins]

@kvanzuijlen yes,
Please revert the contractions changes

[kvanzuijlen]

@kvanzuijlen yes, Please revert the contractions changes

Do you also want me to change existing contractions?

[rarkins]

@kvanzuijlen yes, Please revert the contractions changes

Do you also want me to change existing contractions?

If you think there are others which could be more "simply" understandable then please go ahead, but otherwise it's not essential if you prefer not. Thanks!

[rarkins]

Requires deconflicting

[rarkins]

@HonkingGoose do you approve?

[HonkingGoose]

This is nearly ready:

• Needs maintainer input for some questions
• Some small typo fixes and style changes

Be sure to expand the large file diffs, because some comments are "hiding" there. 😉

[kvanzuijlen]

@rarkins can you decide on the questions put forward by @HonkingGoose? I'll deconflict the PR afterward and make the necessary changes!

[rarkins]

Needs deconflicting. Please see my comments within the Conversations

[rarkins]

Needs git conflicts resolved

[kvanzuijlen]

Hi,

Sorry for my absence. I'll have a look at this later today.

[kvanzuijlen]

It took me a bit longer to look into it, sorry about that. I'm looking into it right now!