consistent internal links (#23)

convert all internal links to use the "ref-" prefix

Author: bcumming

docs/access/index.md

@@ -4,32 +4,32 @@ This documentation guides users through the process of accessing CSCS systems an
 
 !!! note ""
     Before accessing CSCS, you need to have an account at CSCS, and be part of a project that has been allocated resources.
-    More information on how to get an account is available in [accounts and projects][account-management].
+    More information on how to get an account is available in [accounts and projects][ref-account-management].
 
 <div class="grid cards" markdown>
 
 -   :fontawesome-solid-layer-group: __Multi Factor Authentification__
 
     Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA)
 
-    [:octicons-arrow-right-24: MFA][mfa]
+    [:octicons-arrow-right-24: MFA][ref-mfa]
 
 -   :fontawesome-solid-layer-group: __Web Services__
 
     Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA)
 
-    [:octicons-arrow-right-24: Accessing CSCS web services][access-web]
+    [:octicons-arrow-right-24: Accessing CSCS web services][ref-access-web]
 
 -   :fontawesome-solid-layer-group: __SSH Access__
 
     Logging into Clusters on Alps
 
-    [:octicons-arrow-right-24: SSH][access-ssh]
+    [:octicons-arrow-right-24: SSH][ref-ssh]
 
 -   :fontawesome-solid-layer-group: __VSCode__
 
     How to connect VSCode IDE on your laptop with Alps
 
-    [:octicons-arrow-right-24: SSH][access-vscode]
+    [:octicons-arrow-right-24: SSH][ref-access-vscode]
 
 </div>

docs/access/mfa.md

@@ -1,4 +1,4 @@
-[](){#mfa}
+[](){#ref-mfa}
 # Multi Factor Authentification
 
 To access CSCS services and systems users are required to authenticate using multi-factor authentication (MFA).
@@ -10,7 +10,7 @@ An OTP is a six-digit number which changes every 30 seconds.
 OTPs are generated using a tool installed on a device other than the one used to access CSCS services and infrastructure.
 We recommend to use a smartphone with an application such as Google Authenticator to obtain the OTPs.
 
-[](){#mfa-setup}
+[](){#ref-mfa-setup}
 ## Getting Started
 
 When you first log in to any of the CSCS web applications such as UMP, Jupyter, etc., you will be asked to register your device.
@@ -36,7 +36,7 @@ You can download Google Authenticator for your phone:
 * :fontawesome-brands-android: Android: on the [Google Play Store](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2).
 * :fontawesome-brands-apple: iOS: on the [Apple Store](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2).
 
-[](){#mfa-configure-otp}
+[](){#ref-mfa-configure-otp}
 ### Configure the Authenticator
 
 Before starting, ensure that the following pre-requisites are satisfied
@@ -78,7 +78,7 @@ In case users lose access to their mobile device/Authenticator OTP, users can re
 2. From the login screen, click the "Reset OTP" link below the "LOG IN" button
 3. Enter your username and password.
 4. On successful validation of user credentials, users will receive an email with a reset credentials link like the one below, click on the link in the email
-5. The steps are the same as for the first time you [configured the authenticator][mfa-configure-otp].
+5. The steps are the same as for the first time you [configured the authenticator][ref-mfa-configure-otp].
 
 !!! warning
     When replacing your smartphone remember to sync the authenticator app before resetting the old smartphone.

docs/access/ssh.md

@@ -1,9 +1,9 @@
-[](){#access-ssh}
+[](){#ref-ssh}
 # Using SSH
 
-Before accessing CSCS clusters using SSH, first ensure that you have [created a user account][account-management] that is part of a project that has access to the cluster, and have [multi factor authentification][mfa] configured.
+Before accessing CSCS clusters using SSH, first ensure that you have [created a user account][ref-account-management] that is part of a project that has access to the cluster, and have [multi factor authentification][ref-mfa] configured.
 
-[](){#sshservice}
+[](){#ref-ssh-service}
 ## Generating Keys with SSHService
 
 It is not possible to authenticate with a username/password and user-created SSH keys.
@@ -103,7 +103,7 @@ ssh -i ~/.ssh/cscs-key ela.cscs.ch
 To log into a target system at CSCS, you need to perform some additional setup to handle forwarding of SSH keys generated using the SSHService.
 There are two alternatives detailed below.
 
-[](){#ssh-ssh-config}
+[](){#ref-ssh-config}
 ### Adding Ela as a jump host in SSH Configuration
 
 This approach configures Ela as a jump host and creates aliases for the systems that you want to access in `~/.ssh/config` on your laptop or PC.
@@ -148,12 +148,12 @@ After saving this file, one can directly log into `daint.alps.cscs.ch` from your
 ssh daint
 ```
 
-[](){#ssh-ssh-agent}
+[](){#ref-ssh-agent}
 ### Using SSH Agent
 
 Alternatively, the [SSH authentification agent](https://www.ssh.com/academy/ssh/add-command) can be configured to manage the keys.
 
-Each time a new key is generated using the [SSHService][sshservice], add the key to the SSH agent:
+Each time a new key is generated using the [SSHService][ref-ssh-service], add the key to the SSH agent:
 ```
 ssh-add -t 1d ~/.ssh/cscs-key
 ```

docs/access/vscode.md

@@ -1,4 +1,4 @@
-[](){#access-vscode}
+[](){#ref-access-vscode}
 # Connecting with VSCode
 
 [Visual Studio Code](https://code.visualstudio.com/) provides flexible support for remote development.
@@ -107,7 +107,7 @@ Once the tunnel is configured, you can access it from VSCode.
 
 !!! warning
     If you plan to do any intensive work: repeated compilation of large projects or running python code in Jupyter, please see the guide to running on a compute node below.
-    Running intensive workloads on login nodes, which are shared resources between all users, is against CSCS [fair usage][policies-fair-use] of Shared Resources policy.
+    Running intensive workloads on login nodes, which are shared resources between all users, is against CSCS [fair usage][ref-policies-fair-use] of Shared Resources policy.
 
 ### Using with containers
 

docs/access/web.md

@@ -1,14 +1,14 @@
-[](){#access-web}
+[](){#ref-access-web}
 # Accessing CSCS Web Portals
 
 Most services at CSCS are connected to the CSCS Single Sign-On gate.
 This gives users the comfort of not having to sign in multiple times in each individual service connected to this gate and increases security.
 Furthermore, the Single Sign-On gate allow users to recover their forgotten passwords and authenticate using a third-party account. The login page looks like
 
-[](){#web-mfa}
+[](){#ref-web-mfa}
 ## Using MFA to acccess web-based services
 
-After having completed the setup of [MFA][mfa], you will be asked to enter your login/password and the OTP to access all web-based services.
+After having completed the setup of [MFA][ref-mfa], you will be asked to enter your login/password and the OTP to access all web-based services.
 
 Enter username and password.
 

docs/accounts/index.md

@@ -1,4 +1,4 @@
-[](){#account-management}
+[](){#ref-account-management}
 # Getting and Managing Accounts
 
 Users at CSCS have one account that can be used to access all services and systems at CSCS.
@@ -22,11 +22,11 @@ PIs can then invite members of their groups to join their project.
 
 The tool used to manage projects and accounts depends on the platform on which the project was granted:
 
-* The [HPC Platform][hpcp] and [Climate and Weather Platform][cwp] use the [account and resources management tool][ump] at [account.cscs.ch](https://account.cscs.ch)
-* The [Machine Learning Platform][mlp] uses the [project and resources management tool][waldur] at [portal.cscs.ch](https://portal.cscs.ch).
+* The [HPC Platform][ref-platform-hpcp] and [Climate and Weather Platform][ref-platform-cwp] use the [account and resources management tool][ref-account-ump] at [account.cscs.ch](https://account.cscs.ch)
+* The [Machine Learning Platform][ref-platform-mlp] uses the [project and resources management tool][ref-account-waldur] at [portal.cscs.ch](https://portal.cscs.ch).
 
 !!! note
-    The [portal.cscs.ch][waldur] site will be used to manage all projects in the future.
+    The [portal.cscs.ch][ref-account-waldur] site will be used to manage all projects in the future.
 
 ## Signing up for a new account
 

docs/accounts/ump.md

@@ -1,4 +1,4 @@
-[](){#ump}
+[](){#ref-account-ump}
 # Account and Resources Management Tool
 
 The Swiss National Supercomputing Centre (CSCS) offers a web-based tool for users to manage their accounts and projects at [account.cscs.ch](https://account.cscs.ch).

docs/accounts/waldur.md

@@ -1,11 +1,11 @@
-[](){#waldur}
+[](){#ref-account-waldur}
 # The Project and Resources Management Tool
 
 CSCS Account Managers, PIs and deputy PIs can invite users to the respective projects following the below steps on CSCS's new project management portal.
 
 !!! info
-    The new user project management portal is currently only used by the [Machine Learning Platform][mlp]
-    All other platforms use the old [user management portal](ump.md)
+    The new user project management portal is currently only used by the [Machine Learning Platform][ref-platform-mlp]
+    All other platforms use the old [user management portal][ref-account-ump]
 
 ## log in to the portal
 

docs/alps/hardware.md

@@ -1,4 +1,4 @@
-[](){#alps-hardware}
+[](){#ref-alps-hardware}
 # Alps Hardware
 
 Alps is a HPE Cray EX3000 system, a liquid cooled blade-based, high-density system.
@@ -47,27 +47,27 @@ There are currently four node types in Alps, with another becoming available in
 | AMD MI250x     |   12   |   24  |     24      |  96         |
 | AMD MI300A     |   64   |  128  |    512      | 512         |
 
-[](){#gh200-node}
+[](){#ref-alps-gh200-node}
 ### NVIDIA GH200 GPU Nodes
 
 Perry Peak
 
-[](){#zen2-node}
+[](){#ref-alps-zen2-node}
 ### AMD Rome CPU Nodes
 
 EX425
 
-[](){#a100-node}
+[](){#ref-alps-a100-node}
 ### NVIDIA A100 GPU Nodes
 
 Grizzly Peak
 
-[](){#mi200-node}
+[](){#ref-alps-mi200-node}
 ### AMD MI250x GPU Nodes
 
 Bard Peak
 
-[](){#mi300-node}
+[](){#ref-alps-mi300-node}
 ### AMD MI300A GPU Nodes
 
 Parry Peak

docs/alps/index.md

@@ -1,3 +1,4 @@
+[](){#ref-alps}
 # Alps Infrastructure
 
 Alps is a general-purpose compute and data Research Infrastructure (RI) open to the broad community of researchers in Switzerland and the rest of the world.
@@ -14,13 +15,13 @@ Additionally, network segregation ensures secure and isolated communication, wit
 
 -   :fontawesome-solid-signs-post: __Platforms__
 
-    [:octicons-arrow-right-24: Alps Platforms][platforms]
+    [:octicons-arrow-right-24: Alps Platforms][ref-alps-platforms]
 
 -   :fontawesome-solid-signs-post: __Clusters__
 
     The resources on Alps are partitioned and configured into versatile software defined clusters (vClusters).
 
-    [:octicons-arrow-right-24: Alps vClusters][clusters]
+    [:octicons-arrow-right-24: Alps vClusters][ref-alps-clusters]
 
 -   :fontawesome-solid-signs-post: __Hardware__