Merge pull request #2 from dimitri-yatsenko/claude/fix-myst-warnings-01FnWNTWHSr7VrVJBTDBMdLu

Fix MyST build warnings and configuration issues

Author: dimitri-yatsenko

book/00-introduction/25-history.md

@@ -6,8 +6,8 @@ DataJoint's evolution from lab tool to commercial platform reflects its growing
 
 ```{image} ../images/cave-art.jpg
 ---
-:alt: cave painting
-:width: 600px
+alt: cave painting
+width: 600px
 ---
 ```
 ## Academic Origins: From Lab Tool to Open-Source Project

book/20-concepts/02-relational.md

@@ -203,7 +203,6 @@ The most common way to interact with relational databases is through the Structu
 When speaking with database programmers and computer scientists, you will often run into different terminologies. Practical database programmers speak of tables and rows while theoretical data modelers may describe the same things as *relations* and *tuples*.
 
 :::{table} The difference in terminology used in relational theory and relational databases.
-:widths: auto
 :align: center
 |  Relational Theory | Database Programming & SQL  | Description  |
 |:--|:--|:--|

book/20-concepts/04-workflows.md

@@ -84,9 +84,6 @@ Several different notations have been developed, including Chen's original notat
 :::{figure}
 :align: center
 ```{mermaid}
----
-title: Crow's Foot notation.
----
 erDiagram
     EMPLOYEE }o--o{ PROJECT : assigned-to
 ```
@@ -97,9 +94,6 @@ Or using an explicit association table:
 :::{figure}
 :align: center
 ```{mermaid}
----
-title: Crow's Foot notation.
----
 erDiagram
     EMPLOYEE ||--o{ ASSIGNMENT : works-on
     ASSIGNMENT }o--|| PROJECT : assigned-to

book/20-concepts/concepts-quiz.md

@@ -1076,7 +1076,6 @@ E) It eliminates all human judgment
 
 ```{list-table} Grade Scale
 :header-rows: 1
-:widths: 20 20 60
 
 * - Score Range
   - Percentage

book/30-database-design/010-schema.ipynb

@@ -3,49 +3,7 @@
   {
    "cell_type": "markdown",
    "metadata": {},
-   "source": [
-    "---\n",
-    "title: Create Schemas\n",
-    "authors:\n",
-    "  - name: Dimitri Yatsenko\n",
-    "  - date: 2025-01-12\n",
-    "---\n",
-    "\n",
-    "# What is a schema?\n",
-    "\n",
-    "The term schema has two related meanings in the context of databases:\n",
-    "\n",
-    "## 1. Schema as a Data Blueprint\n",
-    "A **schema** is a formal specification of the structure of data and the rules governing its integrity.\n",
-    "It serves as a blueprint that defines how data is organized, stored, and accessed within a database.\n",
-    "This ensures that the database reflects the rules and requirements of the underlying business or research project it supports.\n",
-    "\n",
-    "In structured data models, such as the relational model, a schema provides a robust framework for defining:\n",
-    "* The structure of tables (relations) and their attributes (columns).\n",
-    "* Rules and constraints that ensure data consistency, accuracy, and reliability.\n",
-    "* Relationships between tables, such as primary keys (unique identifiers for records) and foreign keys (references to related records in other tables).\n",
-    "\n",
-    "### Aims of Good Schema Design\n",
-    "* **Data Integrity**: Ensures consistency and prevents anomalies.\n",
-    "* **Query Efficiency**: Facilitates fast and accurate data retrieval, supports complex queries, and optimizes database performance.\n",
-    "* **Scalability**: Allows the database to grow and adapt as data volumes increase.\n",
-    "\n",
-    "### Key Elements of Schema Design\n",
-    "* **Tables and Attributes**: Each table is defined with specific attributes (columns), each assigned a data type.\n",
-    "* **Primary Keys**: Uniquely identify each record in a table.\n",
-    "* **Foreign Keys**: Establish relationships between entities in tables.\n",
-    "* **Indexes**: Support efficient queries.\n",
-    "\n",
-    "Through careful schema design, database architects create systems that are both efficient and flexible, meeting the current and future needs of an organization. The schema acts as a living document that guides the structure, operations, and integrity of the database.\n",
-    "\n",
-    "## 2. Schema as a Database Module\n",
-    "\n",
-    "In complex database designs, the term \"schema\" is also used to describe a distinct module of a larger database with its own namespace that groups related tables together. \n",
-    "This modular approach:\n",
-    "* Separates tables into logical groups for better organization.\n",
-    "* Avoids naming conflicts in large databases with multiple schemas.\n",
-    "\n"
-   ]
+   "source": "---\ntitle: Create Schemas\nauthors:\n  - name: Dimitri Yatsenko\n---\n\n# What is a schema?\n\nThe term schema has two related meanings in the context of databases:\n\n## 1. Schema as a Data Blueprint\nA **schema** is a formal specification of the structure of data and the rules governing its integrity.\nIt serves as a blueprint that defines how data is organized, stored, and accessed within a database.\nThis ensures that the database reflects the rules and requirements of the underlying business or research project it supports.\n\nIn structured data models, such as the relational model, a schema provides a robust framework for defining:\n* The structure of tables (relations) and their attributes (columns).\n* Rules and constraints that ensure data consistency, accuracy, and reliability.\n* Relationships between tables, such as primary keys (unique identifiers for records) and foreign keys (references to related records in other tables).\n\n### Aims of Good Schema Design\n* **Data Integrity**: Ensures consistency and prevents anomalies.\n* **Query Efficiency**: Facilitates fast and accurate data retrieval, supports complex queries, and optimizes database performance.\n* **Scalability**: Allows the database to grow and adapt as data volumes increase.\n\n### Key Elements of Schema Design\n* **Tables and Attributes**: Each table is defined with specific attributes (columns), each assigned a data type.\n* **Primary Keys**: Uniquely identify each record in a table.\n* **Foreign Keys**: Establish relationships between entities in tables.\n* **Indexes**: Support efficient queries.\n\nThrough careful schema design, database architects create systems that are both efficient and flexible, meeting the current and future needs of an organization. The schema acts as a living document that guides the structure, operations, and integrity of the database.\n\n## 2. Schema as a Database Module\n\nIn complex database designs, the term \"schema\" is also used to describe a distinct module of a larger database with its own namespace that groups related tables together. \nThis modular approach:\n* Separates tables into logical groups for better organization.\n* Avoids naming conflicts in large databases with multiple schemas."
   },
   {
    "cell_type": "markdown",
@@ -264,4 +222,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 2
-}
+}