website: work on step-by-step guides

Author: huiwanpnnl

docs/.vitepress/config.mjs

@@ -35,6 +35,7 @@ export default defineConfig({
         {
           text: "Step-by-step Guides",
           items: [
+            { text: "JupyterHub", link: "/nersc/jupyter_at_nersc" },
             { text: "QuickView", link: "/nersc/perlmutter-run-quickview" },
             {
               text: "QuickCompare",

docs/nersc/jupyter_at_nersc.md

@@ -0,0 +1,20 @@
+# Using JupyterHub to log in to NERSC
+
+To use the QuickView family of tools at NERSC, you first need to login to JupyterHub using
+[this link](https://jupyter.nersc.gov/hub/login), which will bring you to a page like the screenshot below.
+
+![JupyterHub login](./login/login-00.png)
+
+Once you've enter your __login__ and __password__ you will need to fill an OTP (One Time Password).
+
+![](./login/login-01.png)
+
+After that, you will be presented with a list of options for where you would like to run your application.
+For the QuickView family, it is better to have hardware with a GPU to allow interactive rendering.
+
+![](./login/login-02.png)
+
+Once you picked your target location and allocation, you will have to wait for some seconds for the service to start.
+
+![](./login/login-03.png)
+

docs/nersc/jupyter_launcher_terminal.png

@@ -1,48 +1,46 @@
 # QuickView @ NERSC
 
-To use QuickView at NERSC, you first need to login
-
-[![](./login/login-00.png) Click on the image to go to the login page](https://jupyter.nersc.gov/hub/login)
-
-Once you've enter your __login__ and __password__ you will need to feel a OTP.
-
-![](./login/login-01.png)
-
-At that point you will presented with a list of options on where you would like to run your application.
-For QuickView it is better to have hardware with a GPU to allow interactive rendering.
-
-![](./login/login-02.png)
-
-Once you picked your target location and allocation, you will have to wait for the service to start.
-
-![](./login/login-03.png)
-
-## QuickView
-
-Once connected, you should start the terminal from the Launcher options of JupyterHub. Then you should go to the directory that contains the data you would like to see. While that step is optional, it may save you some navigation time with the application UI.
-
-Once ready, you should start the application by running:
-
-```sh
-/global/common/software/m4359/quickview
-```
-
-
-
-![](./quickview/quickview-00.png)
-
-Click on the link provided by the application execution.
-Then in the new graphical interface showing in the new browser tab, select the files you aim to load.
-
-![](./quickview/quickview-01.png)
-
-Finally select the fields you want to load and inspect.
-
-![](./quickview/quickview-02.png)
-
-
-## Release resources
-
-Can be access in the Menu `File > Hub Control Panel`
+To use QuickView at NERSC to directly access and analyze data files there,
+users need to first connect to NERSC using JupyterHub, as described
+[on this page](/guides/nersc/jupyter_at_nersc.md).
+
+Once connected,
+
+- Start a Terminal from the Launcher options of JupyterHub.
+  You will likely need to scroll down in the Launcher in order to
+  see the "Other" section and the Terminal icon there, as shown in the screenshot below.
+  Click on the Terminal icon, and the Launcher window should turn into a shell.
+  !["Other" section of JupyterHub Launcher window](/guides/nersc/jupyter_launcher_terminal.png)
+
+- *Optional but recommended*: in the shell, use the `cd` command to go to
+  the directory where your data files are located (or a directory closer to the data files than your home directory).
+  While that step is optional, it may save you quick some clicks later in the graphical UI.
+
+- Starting **QuickView** using the command `/global/common/software/m4359/quickview` in the shell.
+
+- After a few seconds, the Terminal window will provide a URL, similar to the screenshot below.
+  A click on the URL will bring up the graphical UI in a separate brower window or tab.
+  ![](./quickview/quickview-terminal-with-url.png)
+
+- The graphical UI will prompt you to choose connectivity and simulation files, see example below.
+  Double click your connecitivity file and then the simulation file, then
+  click on the blue "Load Files" button in the bottom-right corner
+  ![](./quickview/quickview-file-loading.png)
+
+- Finally select the variables you want to load and inspect.
+  ![](./quickview/quickview-variable-selection.png)
+
+::: warning Reminder: Shut down the server when you are done.
+After finishing your analysis, please remember to shut down the connection to your selected
+server (node) to stop the charging of hours to your project's allocation.
+This is explained at the end of
+[this video](https://docs.nersc.gov/beginner-guide/#keypad-entry-log-in-using-jupyter),
+and below is a recap of the steps (clicks):
+- go to the JupytherHub window/tab in your browser,
+- click `File` in the top-left corner,
+- scroll down and choose `Hub Control Panel`,
+- in the Control Panel brought up in a new browser tab/window, click on the red "stop" button
+  for the server to be shut down. An example is shown in the screenshot below.
 
 ![](./login/login-04.png)
+:::