Documentation Improvements

[stacristo]

Description

Implemented documentation improvements

Closes #2458

Links to documentation:

• https://esmvaltool--2580.org.readthedocs.build/en/2580/introduction.html
• https://esmvaltool--2580.org.readthedocs.build/en/2580/functionalities.html
• https://esmvaltool--2580.org.readthedocs.build/en/2580/quickstart/installation.html

---

Before you get started

• ☝ Create an issue to discuss what you are going to do

Checklist

It is the responsibility of the author to make sure the pull request is ready to review. The icons indicate whether the item will be subject to the 🛠 Technical or 🧪 Scientific review.

• 🛠 This pull request has a descriptive title
• 🛠 Code is written according to the code quality guidelines
• 🛠 Documentation is available
• 🛠 Tests run successfully
• 🛠 The list of authors is up to date
• 🛠 Any changed dependencies have been added or removed correctly
• 🛠 All checks below this pull request were successful

[stacristo]

@LisaBock and @remi-kazeroni Since there was an issue with trying to merge the main remote branch to my local branch where I am applying my edits, I created a new request which based on this original pull request: Orignal pull request.

I hope now that this meets the requirements

[remi-kazeroni]

Thanks @stacristo, I think it was the simplest to open a new PR. I will take a look now.

[remi-kazeroni]

Thanks for the work @stacristo! I think this PR is in good shape and helps improving the clarity of the documentation. I have suggested a couple of improvements, old typos to be fixed and a question to the UET. There is also one subsection that I think was erroneously deleted in this PR. Please let me know if you have any questions or doubts.

[stacristo]

Dear @remi-kazeroni , I have implemented based on your recommendations and checked for typos. Hopefully, it can be merged now

[remi-kazeroni]

Hi @stacristo! Thanks for the changes, the PR looks good to me now. I have pushed a couple of very minor changes to avoid overwriting bits of documentation not touched by this PR. I have left one last suggestion that you might want to consider.

[remi-kazeroni]

It would be good if @LisaBock or @hb326 could have another look at this PR as you have a better overview of the expected changes.

[LisaBock]

Thanks @stacristo for this!

[remi-kazeroni]

If no further comments on this PR, I plan to merge it by tomorrow evening.