Small fixes for web rendering

Author: kushalbakshi

docs/src/client/stores.md

@@ -4,8 +4,8 @@
 
 It is common to enter data during experiments using a graphical user interface.
 
-1. The [DataJoint Works](https://works.datajoint.com) platform is a web-based, fully
-managed service to host and execute data pipelines.
+1. The [DataJoint Works](https://works.datajoint.com) platform is a web-based,
+   end-to-end platform to host and execute data pipelines.
 
 2. [DataJoint LabBook](https://github.com/datajoint/datajoint-labbook) is an open 
 source project for data entry but is no longer actively maintained.

docs/src/faq.md

@@ -1,5 +1,14 @@
 # Quick Start Guide
 
+## Tutorials
+
+The easiest way to get started is through the [DataJoint
+Tutorials](https://github.com/datajoint/datajoint-tutorials). These tutorials are
+configured to run using [GitHub Codespaces](https://github.com/features/codespaces)
+where the full environment including the database is already set up. 
+
+Advanced users can install DataJoint locally. Please see the installation instructions below.
+
 ## Installation
 
 First, please [install Python](https://www.python.org/downloads/) version

docs/src/quick-start.md

@@ -4,8 +4,13 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Using the `dj.Top` restriction\n",
-    "\n",
+    "# Using the dj.Top restriction"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
     "First you will need to [install](../../getting-started/#installation) and [connect](../../getting-started/#connection) to a DataJoint [data pipeline](https://datajoint.com/docs/core/glossary/#data-pipeline).\n",
     "\n",
     "Now let's start by importing the `datajoint` client."
@@ -31,6 +36,13 @@
     "schema = dj.Schema('university')"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Table Definition"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 2,
@@ -87,50 +99,6 @@
     "    \"\"\""
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": 59,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "[2024-12-26 12:03:01,311][INFO]: Table altered\n"
-     ]
-    }
-   ],
-   "source": [
-    "StudentMajor.definition = \"\"\"\n",
-    "-> Student\n",
-    "---\n",
-    "-> Department\n",
-    "declare_date :  date  # when student declared her major\n",
-    "\"\"\"\n",
-    "StudentMajor.alter()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 60,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "-> Student\n",
-      "---\n",
-      "-> Department\n",
-      "declare_date         : date                         # when student declared her major\n",
-      "\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(StudentMajor.describe())"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": 5,
@@ -207,6 +175,13 @@
     "    \"\"\""
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Insert"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 6,
@@ -389,6 +364,13 @@
     "             for key, grade in zip(grade_keys, random.choices(grades, k=len(grade_keys))))"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# dj.Top Restriction"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 29,

docs/src/tutorials/dj-top.ipynb

@@ -6,7 +6,7 @@
    "id": "7fe24127-c0d0-4ff8-96b4-6ab0d9307e73",
    "metadata": {},
    "source": [
-    "# Using the `json` type"
+    "# Using the json type"
    ]
   },
   {