Update documentation

[stuitje]

Description

This PR updates the documentation to professionalise the layout – and add certain features also recently added to the PROTEUS docs – and add a bibliography and tutorial.

The installation instructions have been updated as well, and there is a getting started page. Closes #25 .

@nichollsh if you have time, it would be nice if you could go over the tutorial in particular, as I am not a SOCRATES expert. It is based on python, as that is what most people will likely be familiar with, and uses python/nctools.py as already present in the repo. I also added a requirements file inside the python directory for necessary dependencies. I made it by iterating with Claude Sonnet 5.0 using the JANUS source code and the user guide, and after many modifications, it runs well for me and produces the desired output.

Validation of changes

I built the website locally on Chrome, Safari, Firefox, and also built the mobile version locally on Firefox via an online tool.

Checklist

• I have followed the contributing guidelines
• My code follows the style guidelines of this project
• I have performed a self-review of my code
• My changes generate no new warnings or errors
• I have checked that the tests still pass on my computer
• I have updated the docs, as appropriate
• I have added tests for these changes, as appropriate
• I have checked that all dependencies have been updated, as required

[nichollsh]

Great! Thanks for adding this @stuitje - the documentation is now becoming very robust and useful.

1. I've managed to follow the tutorial. I made some suggestions for improvement below.

2. I also made some other minor tweaks to the documentation pages.

Otherwise, looks good.

[nichollsh]

But also maybe @timlichtenberg will have some suggestions, as he also has experience using SOCRATES.

[stuitje]

Great! Thanks for adding this @stuitje - the documentation is now becoming very robust and useful.

1. I've managed to follow the tutorial. I made some suggestions for improvement below.

2. I also made some other minor tweaks to the documentation pages.

Otherwise, looks good.

Thanks Harrison for the thorough review, very useful! I will get on it :)

[stuitje]

But also maybe @timlichtenberg will have some suggestions, as he also has experience using SOCRATES.

Ah good I will add him as a reviewer.

[nichollsh]

@stuitje let me know when this is ready for another review

[stuitje]

@stuitje let me know when this is ready for another review

It is now! I addressed all comments and also updated the README since it was still, for a large part, the metoffice README.

Thanks Harrison!

[nichollsh]

Great - thanks @stuitje. The CLA check was stuck, for some reason, so I approved and force-merged the branch.

[stuitje]

Great - thanks @stuitje. The CLA check was stuck, for some reason, so I approved and force-merged the branch.

thank you!