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.ts
file. - 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.tsx
file. - For adjustments to the hands-on section, navigate to the
docs
directory. - To make changes to the blog section, navigate to the
blog
directory.
Branches
Development happens on the main
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/2024_11
.
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 main
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 main
after the course has ended.