Links, wording

geldata · Jan 12, 2024 · 89abdc6 · 89abdc6
1 parent ba655f4
commit 89abdc6
Show file tree

Hide file tree

Showing 9 changed files with 29 additions and 13 deletions.
diff --git a/docs/guides/migrations/guide.rst b/docs/guides/migrations/guide.rst
@@ -211,7 +211,7 @@ of the DDL above: a declarative schema as opposed to statements.
 Now let's add the new scalar type mentioned above and give it to the 
 ``User`` type. Our schema will now look like this:
 
-.. code-block:: edgeql-diff
+.. code-block:: sdl-diff
 
       module default {
         type User {

diff --git a/docs/ui/auth_admin.rst b/docs/ui/auth_admin.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_auth_admin:
+
 ==========
 Auth Admin
 ==========

diff --git a/docs/ui/client_settings.rst b/docs/ui/client_settings.rst
@@ -24,21 +24,23 @@ Globals
 Config
 ------
 
-- ``allow_bare_ddl``: Whether DDL is allowed to be executed outside a
-  migration. Default: ``NeverAllow``, can be set to ``AlwaysAllow``.
+- ``allow_bare_ddl``: Whether DDL is allowed to be used outside the normal
+  migration flow. Default: ``NeverAllow``, can be set to ``AlwaysAllow``.
   Note: This parameter accepts enum values, not booleans.
-- ``allow_user_specified_id``: Whether inserts are allowed to set the 
+- ``allow_user_specified_id``: Whether users are allowed to manually set the
   'id' property. Default: ``false``.
-- ``apply_access_policies``: Whether access policies will be applied
+- ``apply_access_policies``: Whether
+  :ref:`access policies <datamodel_access_policies>` will be applied
   when running queries. Default: ``true``. When set to ``false``, any
   and all operations can be used on any object in the database.
 - ``force_database_error``: A hook to force all queries to produce an error.
-  Default: ``'false'``. This parameter takes a ``str`` instead of a ``bool``
-  to allow more verbose messages. The database will attempt to deserialize
-  this ``str`` into a JSON object that must include a ``type`` (which must
-  be an EdgeDB error type name), and may also include ``message``, ``hint``,
-  and ``details`` which can be set ad-hoc by the user. For example, the
-  following is valid input: ``'{ "type": "QueryError", "message": "Did not
+  Default: ``'false'`` (note: a string ``'false'``, not a boolean). This 
+  parameter takes a ``str`` instead of a ``bool`` to allow more verbose
+  messages. The database will attempt to deserialize this ``str`` into a 
+  JSON object that must include a ``type`` (which must be an EdgeDB error
+  type name), and may also include ``message``, ``hint``, and ``details`` 
+  which can be set ad-hoc by the user. For example, the following is
+  valid input: ``'{ "type": "QueryError", "message": "Did not
   work", "hint": "Try doing something else", "details": "Indeed, something
   went really wrong" }'``
 - ``query_execution_timeout``: How long an individual query can run before
@@ -51,5 +53,5 @@ Config
 Query Options
 -------------
 
-- Implicit Limit (``int64``): The number of results to display per query.
-  Default: 100
+- Implicit Limit (``int64``): The maximum number of results to display 
+  per query. Default: 100.
diff --git a/docs/ui/data_explorer.rst b/docs/ui/data_explorer.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_data_explorer:
+
 =============
 Data Explorer
 =============

diff --git a/docs/ui/database_dashboard.rst b/docs/ui/database_dashboard.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_dashboard:
+
 =========
 Dashboard
 =========

diff --git a/docs/ui/editor.rst b/docs/ui/editor.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_editor:
+
 ======
 Editor
 ======

diff --git a/docs/ui/schema_viewer.rst b/docs/ui/schema_viewer.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_schema_viewer:
+
 =============
 Schema Viewer
 =============

diff --git a/docs/ui/ui_home.rst b/docs/ui/ui_home.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_home:
+
 =======
 UI Home
 =======

diff --git a/docs/ui/ui_repl.rst b/docs/ui/ui_repl.rst
@@ -1,3 +1,5 @@
+.. _ref_ui_repl:
+
 ====
 REPL
 ====
-Original file line number
+Diff line change
@@ -1,3 +1,5 @@
+    .. _ref_ui_editor:
     ======
     Editor
     ======
@@ Expand Down @@