Kill reference/sdl

geldata · Feb 20, 2025 · e3d59a0 · e3d59a0
1 parent 4a9f347
commit e3d59a0
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 73 deletions.
diff --git a/docs/datamodel/index.rst b/docs/datamodel/index.rst
@@ -37,16 +37,22 @@ Schema
 |Gel| schemas are declared using **SDL** (Gel's Schema Definition
 Language).
 
-SDL
----
+.. _ref_eql_sdl:
 
-Your schema is defined inside |.gel| files. It's common to define your
-entire schema in a single file called :dotgel:`default`, but you can split it
-across multiple files if you wish.
+Schema Definition Language
+--------------------------
+
+The database schema is defined inside |.gel| files with Gel Schema Definition
+Language, or *SDL* for short. It's common to define the entire schema in
+a single file called :dotgel:`default`, but you can split it across multiple
+files if you wish. Since SDL is declarative in nature, the specific order of
+declarations of module blocks, types, or schema files does not matter.
 
 By convention, your schema files should live in a directory called ``dbschema``
 in the root of your project.
 
+Example:
+
 .. code-block:: sdl
 
     # dbschema/default.gel

diff --git a/docs/reference/index.rst b/docs/reference/index.rst
@@ -13,7 +13,6 @@ Reference
 
 
     edgeql/index
-    sdl/index
     ddl/index
     connection
     environment

diff --git a/docs/reference/sdl/index.rst b/docs/reference/sdl/index.rst