Update the main index

docs/access/index.md

@@ -2,20 +2,28 @@
 
 This documentation guides users through the process of accessing CSCS systems and services.
 
-!!! info
+!!! 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].
 
+<div class="grid cards" markdown>
 
-There are different ways to authenticate your identity in order to access services at CSCS, using a password set by the user. Currently users can be authenticated with:
+-   :fontawesome-solid-layer-group: __Multi Factor Authentification__
 
-* Classic ssh with CSCS username/password, and also with ssh-keys
-* CSCS username/password on different web services. Sessions can be independent from each other so, signing into one service does not necessarily sign the user into another one
-* CSCS username/password on a Single Sign-On gate, which once the user is authenticated, can move between services (connected to this gate) without signing in again
-* Username/password from an external institution, provided that his/her CSCS account has been "linked" to that external identity beforehand and the service uses the Single Sign-On gate
+    Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA)
 
-## Single Sign-On
+    [:octicons-arrow-right-24: MFA][mfa]
 
-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
+-   :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]
+
+-   :fontawesome-solid-layer-group: __SSH Access__
+
+    Logging into Clusters on Alps
+
+    [:octicons-arrow-right-24: SSH][access-ssh]
+
+</div>

docs/access/ssh.md

@@ -1,4 +1,4 @@
-[](){#ssh}
+[](){#access-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.

docs/access/web.md

@@ -1,3 +1,4 @@
+[](){#access-web}
 # Accessing CSCS Web Portals
 
 Most services at CSCS are connected to the CSCS Single Sign-On gate.

docs/index.md

@@ -1,6 +1,30 @@
 # CSCS Documentation
 
-Welcome to the techincal documentation for Alps.
+Start here to get access to CSCS services and Alps
+
+<div class="grid cards" markdown>
+
+-   :fontawesome-solid-layer-group: __Accounts and Projects__
+
+    The first step is to get an account and a project
+
+    [:octicons-arrow-right-24: Accounts and Projects][account-management]
+
+-   :fontawesome-solid-key: __Logging In__
+
+    Once you have an account, you can set up multi factor authentification
+
+    [:octicons-arrow-right-24: Setting up MFA][mfa]
+
+    Then access CSCS services
+
+    [:octicons-arrow-right-24: Accessing CSCS Web Services][access-web]
+
+    [:octicons-arrow-right-24: Using SSH][access-ssh]
+
+</div>
+
+The Alps Research infrastructure hosts multiple platforms and clusters targeting different communities
 
 <div class="grid cards" markdown>
 
@@ -16,7 +40,7 @@ Welcome to the techincal documentation for Alps.
 
     [:octicons-arrow-right-24: Machine Learning Platform][mlp]
 
-    [:octicons-arrow-right-24: Climate and weather Platform][cwp]
+    [:octicons-arrow-right-24: Climate and Weather Platform][cwp]
 
 -   :fontawesome-solid-mountain-sun: __Alps__
 
@@ -28,27 +52,8 @@ Welcome to the techincal documentation for Alps.
 
     [:octicons-arrow-right-24: Alps Hardware](alps/hardware.md)
 
-    [:octicons-arrow-right-24: Alps Network](alps/network.md)
-
     [:octicons-arrow-right-24: Alps Storage](alps/storage.md)
 
-
--   :fontawesome-solid-key: __Getting Access__
-
-    A project is required to access resources on Alps
-
-    [:octicons-arrow-right-24: Applying for an Alps project](https://www.cscs.ch/user-lab/applying-for-accounts)
-
-    CSCS uses multifactor authentification for secure connection to our services and systems
-
-    [:octicons-arrow-right-24: Setting up MFA][mfa]
-
-    [:octicons-arrow-right-24: Logging into vClusters][ssh]
-
-    Manage your project and team in the user management portal
-
-    [:octicons-arrow-right-24: User management portal][ump]
-
 </div>
 
 ## Get in Touch
@@ -71,7 +76,7 @@ If you can't find the information that you need in the documentation, help is av
 
 </div>
 
-# Tools and Services
+## Tools and Services
 
 !!! todo
     Provide some links to the "how" documentation here.