add developers.md and data description

Author: aashishpanta0

developers.md

@@ -0,0 +1,41 @@
+# NSDF Tutorial Codespaces Errors
+
+This Google Docs document describes the possible error with the NSDF tutorial using Codespaces.
+
+---
+
+## Max Number of Codespaces Error
+
+**Error:**
+> You have reached the maximum number of running codespaces.
+
+**Solution:**  
+Go to [https://github.com/codespaces](https://github.com/codespaces)  
+Delete old codespaces and wait for a few minutes.
+
+---
+
+## Dev Configuration Error
+
+**Error:**  
+> codespace was not built properly; run ‘build’ or docker error
+
+### Solution 1: Relaunch Codespace
+1. Exit the codespace  
+2. Set the region to **‘US EAST’**  
+3. Rerun the codespace
+
+### Solution 2: Trigger Action
+If the first solution doesn’t work, try pushing dummy commits to trigger the action workflow. This will build a new Docker container and push it. It should take approximately 6 minutes.
+
+> ⚠️ Note: If you rerun the submitted action/jobs, it may or may not work (50-50 in my experience). So, it's better to submit a new one.  
+> Close the codespaces and start a new one.
+
+---
+
+## Sharing Access Without GitHub or Slides
+
+If users don't have access to the PDF slide or GitHub link:
+
+- Use [TinyURL](https://tinyurl.com/) to shorten the URL
+- Share the shortened link using the projector on the big screen

hands-on/session II/1.Tutorial.ipynb

@@ -972,7 +972,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%%capture\n",
+    "%%capture  # donot remove. This prevents the debugging information that openvisuspy prints by default.\n",
     "## Stop this cell before running another visualization dashboard\n",
     "!python -m panel serve Materials/openvisuspy/src/openvisuspy/dashboards --log-file \"Materials/files/log.log\" --dev --allow-websocket-origin='*' --address=\"{ADDRESS}\" --port \"{PORT}\" --args \"{URL}\" "
    ]
@@ -1021,7 +1021,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%%capture\n",
+    "%%capture  # donot remove. This prevents the debugging information that openvisuspy prints by default.\n",
     "## Stop this cell before running another visualization dashboard\n",
     "!python -m panel serve Materials/openvisuspy/src/openvisuspy/dashboards --log-file \"Materials/files/log.log\" --dev --allow-websocket-origin='*' --address=\"{ADDRESS}\" --port \"{PORT}\" --args \"{URL}\""
    ]
@@ -1063,7 +1063,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%%capture\n",
+    "%%capture  # donot remove. This prevents the debugging information that openvisuspy prints by default.\n",
     "## Stop this cell before running another visualization dashboard\n",
     "!python -m panel serve Materials/openvisuspy/src/openvisuspy/dashboards --log-file \"Materials/files/log.log\" --dev --allow-websocket-origin='*' --address=\"{ADDRESS}\" --port \"{PORT}\" --args \"{URL}\""
    ]

hands-on/session III/3.Tutorial_PetascaleAnalysis.ipynb

@@ -106,7 +106,13 @@
    "source": [
     "# Set your variable of interest\n",
     "\n",
-    "variable='salt' # options are: u,v,w,salt,theta"
+    "variable='salt' # options are: u,v,w,salt,theta\n",
+    "\n",
+    "#u: East-West Ocean Velocity\n",
+    "#v: North-South Ocean Velocity\n",
+    "#w: Vertical Ocean Velocity\n",
+    "#theta: Ocean Temperature\n",
+    "#salt: Ocean Salinity"
    ]
   },
   {