Minor fixes to both README files

Author: EZoni

dashboard/README.md

@@ -7,7 +7,7 @@
 * [Get the Superfacility API Credentials](#Get-the-Superfacility-API-Credentials)
 * [For Maintainers](#For-Maintainers)
 	* [Generate the conda environment lock file](#Generate-the-conda-environment-lock-file)
-	* [Push the Docker container to NERSC](#Push-the-Docker-container-to-NERSC)
+	* [Build and push the Docker container to NERSC](#Build-and-push-the-Docker-container-to-NERSC)
 * [References](#References)
 
 # Overview
@@ -79,10 +79,7 @@ conda-lock install --name synapse-gui environment-lock.yml
 
 2. Move to the [root directory](../) of the repository.
 
-3. Build the Docker image:
-   ```bash
-   docker build --platform linux/amd64 -t synapse-gui -f dashboard.Dockerfile
-   ```
+3. Build the Docker image as described [below](#build-the-docker-image).
 
 4. Run the Docker container:
    ```bash
@@ -96,7 +93,8 @@ conda-lock install --name synapse-gui environment-lock.yml
 
 # Run the Dashboard at NERSC
 
-Coming soon.
+Connect to the [dashboard](https://bellasuperfacility.lbl.gov/) deployed at NERSC through Spin and play around!
+Remember that you need to upload valid Superfacility API credentials in order to launch simulations or train ML models directly from the dashboard.
 
 # Get the Superfacility API Credentials
 
@@ -144,17 +142,34 @@ Following the instructions at [docs.nersc.gov/services/sfapi/authentication/#cli
    conda-lock --file environment.yml --lockfile environment-lock.yml
    ```
 
-## Push the Docker container to NERSC
+## Build and push the Docker container to NERSC
 
 > [!WARNING]
 > Pushing a new Docker container affects the production dashboard deployed at NERSC through Spin.
 
+> [!NOTE]
+> This has been also automated through the Python script [publish_container.py](../publish_container.py), which can be executed via
+> ```bash
+> python publish_container.py --gui
+> ```
+
 > [!TIP]
 > Prune old, unused images periodically in order to free up space on your machine:
 > ```bash
 > docker system prune -a
 > ```
 
+### Build the Docker image
+
+1. Move to the root directory of the repository.
+
+2. Build the Docker image:
+   ```bash
+   docker build --platform linux/amd64 -t synapse-gui -f dashboard.Dockerfile
+   ```
+
+### Push the Docker container
+
 1. Move to the root directory of the repository.
 
 2. Login to the [NERSC registry](https://registry.nersc.gov):
@@ -175,12 +190,7 @@ Following the instructions at [docs.nersc.gov/services/sfapi/authentication/#cli
    docker push -a registry.nersc.gov/m558/superfacility/synapse-gui   
    ```
 
-This has been also automated through the Python script [publish_container.py](../publish_container.py), which can be executed via
-```bash
-python publish_container.py --gui
-```
-
-## References
+# References
 
 * [Using NERSC's `registry.nersc.gov`](https://docs.nersc.gov/development/containers/registry/)
 * [Superfacility API authentication](https://docs.nersc.gov/services/sfapi/authentication/#client)

ml/README.md

@@ -6,7 +6,7 @@
 * [Train ML Models at NERSC](#Train-ML-Models-at-NERSC)
 	* [Manually without Docker](#Manually-without-Docker)
     * [Manually With Docker](#Manually-with-Docker)
-    * [Through the dashboard](#With-the-dashboard) 
+    * [Through the dashboard](#Through-the-dashboard) 
 * [For Maintainers](#For-Maintainers)
 	* [Generate the conda environment lock file](#Generate-the-conda-environment-lock-file)
     * [Build and push the Docker container to NERSC](#Build-and-push-the-Docker-container-to-NERSC)
@@ -146,15 +146,16 @@ This section describes how to train ML models at NERSC.
 ## Through the dashboard
 
 > [!WARNING]
-> When we run ML training jobs through the dashboard, we use NERSC's Superfacility API with the collaboration account `sf558`.
+> When we train ML models through the dashboard, we use NERSC's Superfacility API with the collaboration account `sf558`.
 > Since this is a non-interactive, non-user account, we also use a custom user to pull the image from the [NERSC registry](https://registry.nersc.gov) to Perlmutter.
 > The registry login credentials need to be prepared (only once) in the `$HOME` of user `sf558` (`/global/homes/s/sf558/`), in a file named `registry.profile` with the following content:
 > ```bash
 > export REGISTRY_USER="robot\$m558+perlmutter-nersc-gov"
 > export REGISTRY_PASSWORD="..."
 > ```
 
-Coming soon.
+Connect to the [dashboard](https://bellasuperfacility.lbl.gov/) deployed at NERSC through Spin and click the `Train` button in the `ML` panel.
+Remember that you need to upload valid Superfacility API credentials in order to launch simulations or train ML models directly from the dashboard.
 
 # For Maintainers
 
@@ -195,7 +196,7 @@ Coming soon.
 > docker system prune -a
 > ```
 
-### Build the Docker container
+### Build the Docker image
 
 1. Move to the root directory of the repository.