Merge the RTW documentation with the ESMValTool documentation

[ehogan]

Description

• Closes Merge the RTW documentation with the ESMValTool documentation #3253
• Link to documentation: https://esmvaltool--3684.org.readthedocs.build/en/3684/utils/index.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
• 🛠 Documentation is available
• 🛠 All checks below this pull request were successful

---

To help with the number of pull requests:

• 🙏 We kindly ask you to review two other open pull requests in this repository

[alistairsellar]

Great stuff @ehogan! Exciting to be completing the prototype!

Just two suggested changes:

• one in the comment below (utils structure) and
• can/should we move the actual workflow dir esmvaltool/utils/recipe_test_workflow/recipe_test_workflow up one level, now that esmvaltool/utils/recipe_test_workflow doesn't contain the doc dir?

[ehogan]

Great stuff @ehogan! Exciting to be completing the prototype!

🥳

Just two suggested changes:

• one in the comment below (utils structure) and

I'll address this in the comment 👍

• can/should we move the actual workflow dir esmvaltool/utils/recipe_test_workflow/recipe_test_workflow up one level, now that esmvaltool/utils/recipe_test_workflow doesn't contain the doc dir?

Yes, I was planning to do this via a separate PR after this (which will include a final sanity check of the documentation to ensure the documentation uses the correct paths etc.) 😊

[alistairsellar]

Yes, I was planning to do this via a separate PR after this (which will include a final sanity check of the documentation to ensure the documentation uses the correct paths etc.) 😊

Sounds good - thanks!