An open API service indexing awesome lists of open source software.

https://github.com/eth-cscs/cscs-docs

CSCS public documentation
https://github.com/eth-cscs/cscs-docs

cscs documentation ethz hpc hpc-applications hpc-clusters hpc-tools

Last synced: 3 months ago
JSON representation

CSCS public documentation

Awesome Lists containing this project

README

          

# CSCS Documentation

This repository contains the source code for CSCS' documentation hosted at [docs.cscs.ch](https://docs.cscs.ch)

## Getting Started

If you want to contribute to the documentation, please follow the [contributing](https://docs.cscs.ch/contributing) process.

> [!IMPORTANT]
> to run the serve script, you need to first install [uv](https://docs.astral.sh/uv/getting-started/installation/).

Clone this repository on your PC/laptop, then view the documentation in a browser run `./serve`:
```bash
git clone git@github.com:${githubusername}/cscs-docs.git
cd cscs-docs
./serve
...
INFO - [08:33:34] Serving on http://127.0.0.1:8000/
```
This generates the documentation locally, which can be viewed using a local link, typically [http://127.0.0.1:8000/](http://127.0.0.1:8000/). The documentation will be rebuilt and the webpage reloaded when changed files are saved.

To build the docs in a `site` sub-directory:
```bash
./serve build
```