docs's Introduction

Documentation for the European Environment for Scientific Software Installations (EESSI)

Welcome to the repository that hosts the EESSI documentation, see https://eessi.github.io/docs/.

Basic info

This documentation is rendered via MkDocs, which makes it very easy to preview the result of the changes you make locally.

First, install mkdocs:

  pip install mkdocs-material mkdocs-git-revision-date-localized-plugin

Build the documentation:
```
  make
```
or:
```
  mkdocs build
```
Test the documentation (make sure there are no issues):
```
  make test
```
or:
```
  mkdocs build --strict
```
Start the MkDocs built-in dev-server to preview the documentation as you work on it:
```
  make preview
```
or:
```
  mkdocs serve
```
Visit http://127.0.0.1:8000/ to see the local live preview of the changes you make.
If you prefer building a static preview you can use make, which should result in a site/ subdirectory that contains the rendered documentation.

The rendered version of this documentation at https://eessi.github.io/docs/ is automatically updated on every push to the main branch, thanks to the GitHub Actions workflow defined in .github/workflows/deploy.yml.

The gh-pages branch in this repository contains the rendered version.

https://eessi.github.io/docs/ will only be updated if the tests pass, see GitHub Actions workflow defined in .github/workflows/test.yml.

Note: do not change the files in the gh-pages branch directly!

All your changes will be lost the next time the main branch is updated...