moved Readable docs into Advanced page

Author: dantownsend

docs/src/piccolo/schema/advanced.rst

@@ -0,0 +1,49 @@
+.. _AdvancedSchema:
+
+Advanced
+========
+
+Readable
+--------
+
+Sometimes Piccolo needs a succinct representation of a row - for example, when
+displaying a link in the Piccolo Admin GUI (see :ref:`Ecosystem`). Rather than
+just displaying the row ID, we can specify something more user friendly using
+``Readable``.
+
+.. code-block:: python
+
+    # tables.py
+    from piccolo.table import Table
+    from piccolo.columns import Varchar
+    from piccolo.columns.readable import Readable
+
+
+    class Band(Table, tablename="music_band"):
+        name = Varchar(length=100)
+
+        @classmethod
+        def get_readable(cls):
+            return Readable(template="%s", columns=[cls.name])
+
+
+Specifying the ``get_readable`` classmethod isn't just beneficial for Piccolo
+tooling - you can also use it your own queries.
+
+.. code-block:: python
+
+    Band.select(Band.get_readable()).run_sync()
+
+Here is an example of a more complex ``Readable``.
+
+.. code-block:: python
+
+    class Band(Table, tablename="music_band"):
+        name = Varchar(length=100)
+
+        @classmethod
+        def get_readable(cls):
+            return Readable(template="Band %s - %s", columns=[cls.id, cls.name])
+
+As you can see, the template can include multiple columns, and can contain your
+own text.

docs/src/piccolo/schema/defining.rst

@@ -41,51 +41,3 @@ Connecting to the database
 
 In order to create the table and query the database, you need to provide
 Piccolo with your connection details. See :ref:`Engines`.
-
-Advanced
---------
-
-Readable
-~~~~~~~~
-
-Sometimes Piccolo needs a succinct representation of a row - for example, when
-displaying a link in the Piccolo Admin GUI (see :ref:`Ecosystem`). Rather than
-just displaying the row ID, we can specify something more user friendly using
-``Readable``.
-
-.. code-block:: python
-
-    # tables.py
-    from piccolo.table import Table
-    from piccolo.columns import Varchar
-    from piccolo.columns.readable import Readable
-
-
-    class Band(Table, tablename="music_band"):
-        name = Varchar(length=100)
-
-        @classmethod
-        def get_readable(cls):
-            return Readable(template="%s", columns=[cls.name])
-
-
-Specifying the ``get_readable`` classmethod isn't just beneficial for Piccolo
-tooling - you can also use it your own queries.
-
-.. code-block:: python
-
-    Band.select(Band.get_readable()).run_sync()
-
-Here is an example of a more complex ``Readable``.
-
-.. code-block:: python
-
-    class Band(Table, tablename="music_band"):
-        name = Varchar(length=100)
-
-        @classmethod
-        def get_readable(cls):
-            return Readable(template="Band %s - %s", columns=[cls.id, cls.name])
-
-As you can see, the template can include multiple columns, and can contain your
-own text.

docs/src/piccolo/schema/index.rst

@@ -8,3 +8,4 @@ The schema is how you define your database tables, columns and relationships.
 
     ./defining
     ./column_types
+    ./advanced