[doc] Revamp the documentation

[vkarak]

The documentation is almost entirely rewritten and updated. Key features:

• All individual small tutorials are replaced by a single central tutorial + how to articles
• New topics are covered and older, less relevant topics, are toned down or removed.
• All of the tutorial and how to examples now run inside Docker containers

Todos

• [x] Provide instructions for building the single node tutorial container
• [x] Open issues for topics to cover in the future
  • How to write custom schedulers (#2610)
  • Custom system auto-detection beyond "hostname" (#3160)
  • Add automation to publish ready tutorial images (#3161)
• [x] Clean up the "Configuring ReFrame for Your Site" page; several topics are covered already in the tutorial. Convert any still uncovered topic to a how to article.
• [x] Remove unused listings as well as the script that used to generate the listings in the old docs.
• [x] Update the landing page and especially the part Where to go from here.
• [x] Update tutorial once #3157 is merged.
• [x] Add a redirection of the old tutorials.html to the new tutorial.html.
• [x] Move the old tutorial examples.
• [x] Add proper credits for the Slurm Docker compose.

Closes #2636.

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 86.67%. Comparing base (a278d9a) to head (9607459). Report is 1 commits behind head on develop.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## develop #3095 +/- ## ======================================== Coverage 86.67% 86.67% ======================================== Files 61 61 Lines 12139 12139 ======================================== Hits 10521 10521 Misses 1618 1618 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[pep8speaks]

Hello @vkarak, Thank you for updating!

Cheers! There are no PEP8 issues in this Pull Request!Do see the ReFrame Coding Style Guide

Comment last updated at 2024-04-20 16:45:35 UTC