website: update info on installation at NERSC

Author: huiwanpnnl

docs/.vitepress/config.mjs

@@ -29,7 +29,7 @@ export default defineConfig({
           text: "At NERSC",
           items: [
             { text: "Quickstart",          link: "/nersc/index" },
-            { text: "(not-yet-)Public Installation", link: "/nersc/public_installation" },
+            { text: "Public Installation", link: "/nersc/public_installation" },
             { text: "User's Installation", link: "/nersc/users_installation" },
           ],
         },

docs/nersc/index.md

@@ -1,5 +1,6 @@
 # The QuickView tool family at NERSC
 
+![NERSC logo](/logos/nersc.png)
 Our tools have been installed at NERSC,
 the [National Energy Research Scientific Computing Center](https://www.nersc.gov/),
 and are continually updated there.
@@ -24,12 +25,12 @@ on separate pages:
 
 - **QuickView version 2** can be launched using the following command:
 ```
-/global/cfs/projectdirs/m4359/tools/quickview2
+/global/common/software/m4359/quickview2
 ```  
 
 - **QuickCompare** can be launched using the following command:
 ```
-/global/cfs/projectdirs/m4359/tools/quickcompare
+/global/common/software/m4359/quickcompare
 ```
 
 - After a few seconds, the terminal window will provide a URL.
@@ -81,7 +82,7 @@ Also see below for a recap of the steps (clicks).
 
 
 
-## For NERSC users who have not used JupyterHub
+## Tips for NERSC users who have not used JupyterHub
 
 Please see
 [this section of NERSC's documentation](https://docs.nersc.gov/beginner-guide/#keypad-entry-log-in-using-jupyter),
@@ -90,7 +91,7 @@ to learn about the service.
 
 Alternatively, follow our step-by-step description [here](./jupyter_at_nersc.md)
 
-## If you do not yet have any user account at  NERSC
+## Information for users who do not yet have an account at  NERSC
 
 Information on [this page](https://docs.nersc.gov/accounts/#obtaining-an-account)
 can help you get started.

docs/nersc/public_installation.md

@@ -1,74 +1,92 @@
-# NERSC setup explained
+# Developers' Installation at NERSC
 
 The QuickView family of tools are Python packages.
-We have installed them and have been frequently updating them under
-NERSC project m4359 associated with the SciDAC project that
-has been funding our development.
+They have been installed and are frequently updated at NERSC under project m4359.
 
-We are working on making the installation publicly accessible by
-all NERSC users. In the meantime, NERSC users can use the following
-commands to access QuickView and QuickCompare, instead.
+NERSC users who would like to **use** the developers' installation
+can start a terminal (shell) window through NERSC's JupyterHub
+(see step-by-step guide [here](./jupyter_at_nersc))
+and then use the following commands to start QuickView and QuickCompare,
+respectively.
 
 ```
-/global/cfs/projectdirs/m4359/tools/quickview2
+/global/common/software/m4359/quickview2
 ```
 
 ```
-/global/cfs/projectdirs/m4359/tools/quickcompare
+/global/common/software/m4359/quickcompare
 ```
 
-If you want to have your own installation at a location of your choices,
-please take a look at [this page](./users_installation.md).
+For installing the tools at a location of the user's choice,
+an example is provided on [this page](./users_installation.md).
 
-::: danger The rest of this page will be updated after we consolidate
-QuickView and QuickCompare into one environment.
-:::
+The remainder of this page documents how the developers' installation was done.
 
-## Create custom conda environments
 
-Create a directory for all the conda environments we aim to enable for our users.
+## Setting default permissions
 
-```sh
-mkdir -p /global/common/software/m4359/conda-envs
+To allow any developer in project m4359 to install, uninstall, or update
+and to allow all NERSC users to use the installtion, we set the default permission using
+```
+umask 002
 ```
 
-Then for each project we will create an environment inside that directory.
+## One-time action: creating custom conda environment
+
 
 ```sh
+mkdir -p /global/common/software/m4359/conda-envs
+
 module load conda
-conda create --prefix /global/common/software/m4359/conda-envs/e3sm-quickview python=3.13
+conda create --prefix /global/common/software/m4359/conda-envs/quickview-family python=3.13
+```
+
+## First installation
+
 ```
+conda activate /global/common/software/m4359/conda-envs/quickview-family
+conda install conda-forge::e3sm-quickview 
+conda install conda-forge::e3sm_compareview 
+```
+
+## Updating to newer versions 
 
-After that you can activate such environment and install the application like QuickView
+Different members of the QuickView tool family are versioned separately.
+The current (newest) version numbers are summarized in the table at the beginning
+of [this page](../guides/install_and_lauch).
+The following commands were used to update QuickView to version 2.1.1
+and QuickCompare to version 1.3.5.
 
 ```sh
-conda activate /global/common/software/m4359/conda-envs/e3sm-quickview
-conda install e3sm-quickview
+module load conda
+conda activate /global/common/software/m4359/conda-envs/quickview-family
+
+conda install "e3sm-quickview>=2.1.2"
+conda install "e3sm_compareview>=1.3.5"
 ```
 
-## Executable Shortcut
+## Shortcuts to the executables
 
-Inside `/global/common/software/m4359/` you can create shell script that will provide a shortcut for starting each application.
+The commands listed at the beginning of this page are in fact scripts
+with the following contents. These scripts were created to allow
+the users to start any tool in the QuickView family using a single command.
 
-For example, we've created `/global/common/software/m4359/quickview` with the following content
+`/global/common/software/m4359/quickview2` is a script with the following contents
 
 ```sh
 #!/usr/bin/env bash
 
 module load conda
-conda activate /global/common/software/m4359/conda-envs/e3sm-quickview
+conda activate /global/common/software/m4359/conda-envs/quickview-family
 quickview -p 0
 ```
 
-And to make that file executable, you can run `chmod +x /global/common/software/m4359/quickview` to streamline its usage.
-
-## Updating an application
-
-In order to update a given application you will need to find the version you want to install and then run something like:
+Similarly, `/global/common/software/m4359/quickcompare` is a script with the following contents
 
 ```sh
-module load conda
-conda activate /global/common/software/m4359/conda-envs/e3sm-quickview
+#!/usr/bin/env bash
 
-conda install "e3sm-quickview>=1.3.3" # <== fix version
+module load conda
+conda activate /global/common/software/m4359/conda-envs/quickview-family
+quickcompare -p 0
 ```