re-order chapters

dimitri-yatsenko · dimitri-yatsenko · commit 5862caaf59d6 · 2025-10-12T18:43:16.000-05:00
diff --git a/book/20-concepts/00-databases.md b/book/20-concepts/00-databases.md
diff --git a/book/20-concepts/01-models.md b/book/20-concepts/01-models.md
diff --git a/book/30-schema-design/055-normalization.ipynb b/book/30-schema-design/055-normalization.ipynb
@@ -203,6 +203,13 @@
         "Now department information is stored once, and there are no transitive dependencies. Each attribute directly depends on its table's primary key.\n"
       ]
     },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "\n"
+      ]
+    },
     {
       "cell_type": "markdown",
       "metadata": {},
diff --git a/book/80-examples/000-example-designs.ipynb b/book/80-examples/000-example-designs.ipynb
@@ -17,7 +17,105 @@
   {
    "cell_type": "markdown",
    "metadata": {},
-   "source": []
+   "source": [
+    "## Overview of Examples\n",
+    "\n",
+    "This section presents a variety of schema examples that demonstrate different aspects of DataJoint design principles. Each example showcases specific patterns, relationships, and use cases ranging from classic database tutorials to real-world scientific applications.\n",
+    "\n",
+    "### Classic Database Examples\n",
+    "\n",
+    "These examples are adapted from well-known database tutorials to show how traditional relational designs map to DataJoint's entity-workflow model.\n",
+    "\n",
+    "#### [Classic Sales Database](010-classic-sales.ipynb)\n",
+    "The classic MySQL tutorial sales database featuring customers, orders, products, and employees. This example demonstrates:\n",
+    "- Traditional business database design\n",
+    "- Many-to-many relationships through order details\n",
+    "- Employee management hierarchies\n",
+    "- Product lines and order fulfillment\n",
+    "\n",
+    "#### [University Database](015-university.ipynb)\n",
+    "A university course enrollment system with students, courses, instructors, and enrollments. This example illustrates:\n",
+    "- Academic record keeping\n",
+    "- Course registration workflows\n",
+    "- Student-course many-to-many relationships\n",
+    "- Grade tracking and prerequisites\n",
+    "\n",
+    "#### [Nations Database](030-nations.ipynb)\n",
+    "A geographical database with countries, regions, and continents from the MariaDB tutorial. This example shows:\n",
+    "- Hierarchical geographical relationships\n",
+    "- Lookup tables for standardized data\n",
+    "- Regional groupings and classifications\n",
+    "\n",
+    "### Conceptual Examples\n",
+    "\n",
+    "These examples focus on specific design patterns and conceptual challenges in database modeling.\n",
+    "\n",
+    "#### [Hotel Reservation System](040-hotel.ipynb)\n",
+    "A complete hotel management system with rooms, reservations, check-ins, and check-outs. This design exercise demonstrates:\n",
+    "- Time-series data (room availability and pricing)\n",
+    "- Business rule enforcement (no double-booking, check-in requires reservation)\n",
+    "- Guest management and payment processing\n",
+    "- Temporal queries (who stayed when, room history)\n",
+    "\n",
+    "#### [Social Generations](044-generations.ipynb)\n",
+    "Defines social generations as birth cohorts sharing cultural and historical experiences. This example explores:\n",
+    "- Lookup tables for reference data\n",
+    "- Birth year ranges and generational characteristics\n",
+    "- Cultural archetypes and life principles\n",
+    "- Using DataJoint to model sociological concepts\n",
+    "\n",
+    "#### [Languages and Proficiency](050-languages.ipynb)\n",
+    "A many-to-many relationship design tracking people and their language skills using international standards. This comprehensive example demonstrates:\n",
+    "- **ISO 639-1 language codes**: Standardized two-letter codes for major world languages\n",
+    "- **CEFR proficiency levels**: Common European Framework of Reference for Languages (A1-C2)\n",
+    "- **Association tables**: `Proficiency` as a workflow step linking people, languages, and levels\n",
+    "- **Lookup tables**: Both `Language` and `CEFRLevel` with predefined, standardized content\n",
+    "- **International standards**: Using established frameworks ensures consistency and compatibility\n",
+    "- **Sample queries**: Finding multilingual individuals, proficient speakers, and language statistics\n",
+    "\n",
+    "### Organizational Examples\n",
+    "\n",
+    "These examples model organizational structures and hierarchies.\n",
+    "\n",
+    "#### [Management Hierarchy](060-management.ipynb)\n",
+    "Demonstrates self-referencing tables and organizational relationships. This example shows:\n",
+    "- Employees managing other employees (recursive relationships)\n",
+    "- Department structure with chairs and budgets\n",
+    "- Organizational hierarchies and reporting chains\n",
+    "- One-to-one relationships (department chairs)\n",
+    "- Normalized department data (codes, names, budgets, locations)\n",
+    "\n",
+    "### Scientific Examples\n",
+    "\n",
+    "Real-world scientific applications demonstrating DataJoint in research contexts.\n",
+    "\n",
+    "#### [Allen Common Coordinate Framework](065-allen-ccf.ipynb)\n",
+    "The Allen Brain Atlas coordinate system for mouse brain anatomy. This example illustrates:\n",
+    "- 3D spatial coordinates and brain structure atlases\n",
+    "- Hierarchical anatomical relationships\n",
+    "- Integration with neuroimaging data\n",
+    "- Real scientific data pipeline from the DataJoint Elements project\n",
+    "- Published standards in neuroscience research\n",
+    "\n",
+    "#### [Julia Sets](070-julia.ipynb)\n",
+    "Computational visualization of Julia sets from fractal mathematics. This example demonstrates:\n",
+    "- Computed tables for mathematical functions\n",
+    "- Parameter spaces and computational workflows\n",
+    "- Image generation and visualization\n",
+    "- Using DataJoint for reproducible computational art\n",
+    "- Automatic computation with `populate()`\n",
+    "\n",
+    "---\n",
+    "\n",
+    "Each example is self-contained with:\n",
+    "- Complete schema definitions\n",
+    "- Sample data population\n",
+    "- Example queries demonstrating key concepts\n",
+    "- Visual diagrams showing table relationships\n",
+    "- Code that you can run and modify\n",
+    "\n",
+    "Browse through these examples to see different design patterns in action and learn how to apply DataJoint principles to your own domains.\n"
+   ]
   }
  ],
  "metadata": {
diff --git a/book/80-examples/010-classic-sales.ipynb b/book/80-examples/010-classic-sales.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Example: Classic Sales\n",
+    "# Classic Sales\n",
     "\n",
     "This is the classic sales database provided as part of the MySQL tutorial. http://www.mysqltutorial.org/mysql-sample-database.aspx\n",
     "\n",
diff --git a/book/80-examples/015-university.ipynb b/book/80-examples/015-university.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Example: University"
+    "# University"
    ]
   },
   {
diff --git a/book/80-examples/030-nations.ipynb b/book/80-examples/030-nations.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Example: Nations"
+    "# Nations"
    ]
   },
   {
diff --git a/book/80-examples/040-hotel.ipynb b/book/80-examples/040-hotel.ipynb
@@ -5,7 +5,7 @@
    "id": "6e26075b",
    "metadata": {},
    "source": [
-    "# Example: Hotel\n",
+    "# Hotel\n",
     "\n",
     "## Assignment\n",
     "\n",
diff --git a/book/80-examples/044-generations.ipynb b/book/80-examples/044-generations.ipynb
@@ -5,7 +5,7 @@
    "id": "770f5f50",
    "metadata": {},
    "source": [
-    "# Example: Social Generations\n",
+    "# Social Generations\n",
     "\n",
     "## Social Generations and Their Meaning\n",
     "\n",
diff --git a/book/80-examples/050-languages.ipynb b/book/80-examples/050-languages.ipynb
@@ -4,7 +4,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "# Example: Languages \n",
+        "# Languages \n",
         "\n",
         "This example demonstrates a classic many-to-many relationship design using an association table. We'll track people and the languages they speak, along with their proficiency levels using the internationally recognized CEFR standard.\n",
         "\n",
diff --git a/book/80-examples/060-management.ipynb b/book/80-examples/060-management.ipynb
@@ -4,7 +4,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "# Example: Management Hierarchy\n",
+        "# Management Hierarchy\n",
         "\n",
         "This example demonstrates self-referencing tables and hierarchical data structures, showing how to model organizational relationships where employees manage other employees. It also showcases the benefits of using lookup tables for normalized data design.\n",
         "\n",
diff --git a/book/80-examples/065-allen-ccf.ipynb b/book/80-examples/065-allen-ccf.ipynb
@@ -5,7 +5,7 @@
    "id": "860e00ba",
    "metadata": {},
    "source": [
-    "# Example: Allen CCF\n",
+    "# Allen CCF\n",
     "\n",
     "The Allen Common Coordinate Framework is a 3D atlas of the mouse brain [@10.1016/j.cell.2020.04.007].\n",
     "It defines a coordinate system for the brain, with the origin at the anterior commissure and the x-axis pointing forward, the y-axis pointing left, and the z-axis pointing dorsal.\n",
diff --git a/book/80-examples/070-julia.ipynb b/book/80-examples/070-julia.ipynb
@@ -5,7 +5,7 @@
    "id": "8607eb0e",
    "metadata": {},
    "source": [
-    "# Example: Julia Sets\n",
+    "# Julia Fractals\n",
     "\n",
     "The following is a quick introduction to Julia Sets"
    ]

Original file line number	Diff line number	Diff line change
`@@ -203,6 +203,13 @@`
`203`	`203`	`"Now department information is stored once, and there are no transitive dependencies. Each attribute directly depends on its table's primary key.\n"`
`204`	`204`	`]`
`205`	`205`	`},`
	`206`	`+ {`
	`207`	`+ "cell_type": "markdown",`
	`208`	`+ "metadata": {},`
	`209`	`+ "source": [`
	`210`	`+ "\n"`
	`211`	`+ ]`
	`212`	`+ },`
`206`	`213`	`{`
`207`	`214`	`"cell_type": "markdown",`
`208`	`215`	`"metadata": {},`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"cell_type": "markdown",`
`5`	`5`	`"metadata": {},`
`6`	`6`	`"source": [`
`7`		`- "# Example: University"`
	`7`	`+ "# University"`
`8`	`8`	`]`
`9`	`9`	`},`
`10`	`10`	`{`