JSC Hands On
This project is intended to document all steps a user has to go through in order to run codes on our supercomputers. It is complemented by a theoretical part consisting of presentations for various topics.
A rendered HTML version of the master guide can be found at https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/
How to modify
- To make changes to the main page such as altering the description or adding links, you'll need to modify the
docusaurus.config.tsfile. - If you wish to edit the text below the pictures or add new ones, you'll find the relevant code in the
src/components/HomepageFeatures/index.tsxfile. - For adjustments to the hands-on section, navigate to the
docsdirectory. - To make changes to the blog section, navigate to the
blogdirectory.
Branches
Development happens on the master branch.
An instance branch is created for every time the course is tought, following the naming scheme instances/<YYYY>_<MM> where <YYYY> and <MM> are the year and month in the Gregorian calendar the course starts in, e.g. instances/2021_05.
Instance branches start by filling in place holders for things that change from one iteration to another, e.g. compute project names and the course date.
If there is activity on the master branch, the instance branch is rebased to sit on top of it, until the course starts.
Changes that are made during the course go on the instance branch.
If they are to be included in the material for subsequent instances, they are cherry-picked into master after the course has ended.
Rendered HTML for instance branches is deployed to a subdirectory <YYYY>_<MM>, e.g. for instances/2022_05.