Skip to content
Snippets Groups Projects
README.md 1.53 KiB
Newer Older
# ZIH HPC Documentation

Martin Schroschk's avatar
Martin Schroschk committed
This repository contains the documentation of the HPC systems and services provided at
https://doc.zih.tu-dresden.de/ by [TU Dresden/ZIH](https://tu-dresden.de/zih/).

## Setup

We decided against a classical wiki software. Instead, we make use of the static site generator
[mkdocs](https://www.mkdocs.org/). It creates static html files from markdown source files. All
(configuration, layout and content) files will be managed within this git repository. The
Martin Schroschk's avatar
Martin Schroschk committed
documentation pages and configuration files are found in the folder `doc.zih.tu-dresden.de`. The
generated static html files, i.e, the documentation, is deployed to a web server. Several checks
within the CI/CD pipeline help to ensure a high quality documentation.

## Reporting Issues

Martin Schroschk's avatar
Martin Schroschk committed
Issues concerning this documentation can reported via the GitLab
[issue tracking system](https://gitlab.hrz.tu-chemnitz.de/zih/hpcsupport/hpc-compendium/-/issues).
Martin Schroschk's avatar
Martin Schroschk committed
Please check for any already existing issue before submitting your issue in order to avoid duplicate
Martin Schroschk's avatar
Martin Schroschk committed
issues.

**Reminder:** Non-documentation issues and requests need to be send as ticket to
[hpcsupport@zih.tu-dresden.de](mailto:hpc-support@tu-dresden.de).
Martin Schroschk's avatar
Martin Schroschk committed
Contributions from user-side are highly welcome. Please refer to
Jan Frenzel's avatar
Jan Frenzel committed
[Contribution guide](doc.zih.tu-dresden.de/docs/contrib/howto_contribute.md) to get started.
Martin Schroschk's avatar
Martin Schroschk committed
The repository has two licenses:
Martin Schroschk's avatar
Martin Schroschk committed
* All documentation is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
Martin Schroschk's avatar
Martin Schroschk committed
* All software components are licensed under MIT license.