Add github workflow to check notebook syntax is valid json (#407)

## Problem

A notebook was accidentally committed with syntax errors that prevent it
from being viewed or run.

## Solution

- Add a test workflow to ensure all notebooks contain valid json on
every commit.
- Fix the broken notebook

If you commit a notebook with broken JSON formatting, you will now see a
failed workflow with error message like this:

<img width="819" alt="Screenshot 2025-02-19 at 3 14 08 PM"
src="https://github.com/user-attachments/assets/b682c6ae-1f06-4086-b563-edac3553bced"
/>


## Type of Change

- [x] Bug fix (non-breaking change which fixes an issue)

Author: jhamon

.github/scripts/validate-notebook-formats.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+import nbformat
+import os
+import sys
+
+def validate_notebook(notebook_path):
+    try:
+        with open(notebook_path, "r", encoding="utf-8") as f:
+            nb = nbformat.read(f, as_version=4)
+        nbformat.validate(nb)
+        print(f"Validated: {notebook_path}")
+    except Exception as e:
+        print(f"Validation failed for {notebook_path}: {e}", file=sys.stderr)
+        return False
+    return True
+
+def main():
+    has_error = False
+    # Walk through the repository to find all .ipynb files
+    failing_notebooks = []
+    for root, _, files in os.walk("."):
+        for file in files:
+            if file.endswith(".ipynb"):
+                notebook_path = os.path.join(root, file)
+                if not validate_notebook(notebook_path):
+                    failing_notebooks.append(notebook_path)
+                    has_error = True
+
+    if has_error:
+        print()
+        print(f"The following notebooks did not conform to the expected JSON format:")
+        for notebook in failing_notebooks:
+            print(f"  - {notebook}")
+        print()
+        print("Please fix these notebooks and push again.")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

.github/workflows/validate.yaml

@@ -0,0 +1,25 @@
+name: Validate Notebook JSON
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  validate-notebooks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: pip install nbformat
+
+      - name: Validate all notebooks
+        run: |
+          python .github/scripts/validate-notebook-formats.py

learn/assistant/pinecone-assistant-getting-started.ipynb

@@ -20,7 +20,7 @@
       "source": [
         "# Pinecone Assistant Getting Started\n",
         "\n",
-        "Welcome to the getting started Notebook for [Pinecone assistant](https://www.pinecone.io/blog/pinecone-assistant/)!",
+        "Welcome to the getting started Notebook for [Pinecone assistant](https://www.pinecone.io/blog/pinecone-assistant/)!"
       ],
       "metadata": {
         "id": "IpHsLVa0mAJe"