Merge branch 'main' into cicd-kb-port

Author: bcumming

.github/CODEOWNERS

@@ -1,5 +1,5 @@
 * @bcumming @msimberg @RMeli
-docs/services/jupyterlab.md @rsarm
+docs/access/jupyterlab.md @rsarm
 docs/services/firecrest @jpdorsch @ekouts
 docs/software/communication @Madeeks @msimberg
 docs/software/devtools/linaro @jgphpc

.github/workflows/docs_merge_queue.yaml

@@ -0,0 +1,25 @@
+name: build docs (merge queue)
+
+on:
+  merge_group:
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v3
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install --upgrade pip
+      - run: |
+          pip install -r requirements.txt
+      - run: rm -rf site
+      - run: cat mkdocs.yml
+      - run: mkdocs build --strict

docs/access/index.md

@@ -26,6 +26,12 @@ This documentation guides users through the process of accessing CSCS systems an
 
     [:octicons-arrow-right-24: SSH][ref-ssh]
 
+-   :simple-jupyter: __JupyterLab__
+
+    JupyterLab is a feature-rich notebook authoring application and editing environment.
+
+    [:octicons-arrow-right-24: JupyterLab][ref-jupyter]
+
 -   :fontawesome-solid-layer-group: __VSCode__
 
     How to connect VSCode IDE on your laptop with Alps

docs/access/jupyterlab.md

@@ -26,13 +26,6 @@ Eiger is an Alps cluster that provides compute nodes and file systems designed t
         * The versions of compilers, `cray-mpich`, Python and libraries in uenv are up to date.
         * The scientific application uenv have up to date versions of the supported applications.
 
-    ### Unimplemented features
-
-    !!! under-construction "Jupyter is not yet available"
-        [Jupyter][ref-jlab] has not yet been configured on `Eiger.Alps`.
-
-        **It will be deployed as soon as possible and this documentation will be updated accordingly**
-
     ### Minor changes
 
     !!! change "Slurm is updated from version 23.02.6 to 24.05.4"
@@ -160,7 +153,7 @@ See the Slurm documentation for instructions on how to run jobs on the [AMD CPU
 
 ### JupyterHub 
 
-A JupyterHub service for Eiger is available at [https://jupyter-eiger.cscs.ch](https://jupyter-eiger.cscs.ch).
+A [JupyterHub][ref-jupyter] service for Eiger is available at [https://jupyter-eiger.cscs.ch](https://jupyter-eiger.cscs.ch).
 
 ### FirecREST
 

docs/clusters/eiger.md

@@ -110,8 +110,6 @@ If you cannot find the information that you need in the documentation, help is a
 
     [:octicons-arrow-right-24: CI/CD for external projects](services/cicd.md)
 
-    [:octicons-arrow-right-24: JupyterLab](services/jupyterlab.md)
-
 
 -   :fontawesome-solid-hammer: __Software__
 

docs/index.md

@@ -12,11 +12,5 @@
     FirecREST is a RESTful API for programmatically accessing High-Performance Computing resources.
 
     [:octicons-arrow-right-24: FirecREST][ref-firecrest]
-
--   :simple-jupyter: __JupyterLab__
-
-    JupyterLab is a feature-rich notebook authoring application and editing environment.
-
-    [:octicons-arrow-right-24: JupyterLab][ref-jlab]
 </div>
 

docs/services/index.md

@@ -53,7 +53,7 @@ Start the image and activate the Julia[up] HPC setup by loading the following vi
         uenv start julia/25.5:v1 --view=juliaup,modules
         ```
 
-There is also a view `jupyter` available, which is required for [using Julia in JupyterHub][using-julia-in-jupyterhub].
+There is also a view `jupyter` available, which is required for [using Julia in JupyterHub][using-julia-in-jupyter].
 
 !!! info "Automatic installation of Juliaup and Julia"
     The installation of `juliaup` and the latest `julia` version happens automatically the first time when `juliaup` is called:

docs/services/jupyterlab.md

@@ -41,6 +41,7 @@ nav:
     - 'Multi Factor Authentication (MFA)': access/mfa.md
     - 'Web Services': access/web.md
     - 'SSH': access/ssh.md
+    - 'JupyterLab': access/jupyterlab.md
     - 'VSCode': access/vscode.md
   - 'Software':
     - software/index.md
@@ -97,7 +98,6 @@ nav:
     - services/index.md
     - 'FirecREST': services/firecrest.md
     - 'CI/CD': services/cicd.md
-    - 'JupyterLab': services/jupyterlab.md
   - 'Running Jobs':
     - running/index.md
     - 'Slurm': running/slurm.md