Use gel substitution directives

docs/cloud/index.rst

@@ -21,7 +21,7 @@ Cloud
     deploy/railway
 
 
-Gel Cloud is a fully managed, effortless cloud database service,
+|Gel| Cloud is a fully managed, effortless cloud database service,
 engineered to let you deploy your database instantly and connect from
 anywhere with near-zero configuration.
 
@@ -40,12 +40,12 @@ Try a guide for connecting your app running on your platform of choice:
 
 
 To connect your apps running on other platforms, generate a dedicated
-secret key for your instance with ``gel cloud secretkey create`` or via the
+secret key for your instance with :gelcmd:`cloud secretkey create` or via the
 web UI's “Secret Keys” pane in your instance dashboard. Create two environment
 variables accessible to your production application:
 
-* ``GEL_SECRET_KEY`` - contains the secret key you generated
-* ``GEL_INSTANCE`` - the name of your Gel Cloud instance (``<org-name>/<instance-name>``)
+* :gelenv:`SECRET_KEY` - contains the secret key you generated
+* :gelenv:`INSTANCE` - the name of your |Gel| Cloud instance (``<org-name>/<instance-name>``)
 
 .. edb:youtube-embed:: IG1MggUzzH4
 
@@ -56,15 +56,15 @@ Two ways to use Gel Cloud
 1. CLI
 ^^^^^^
 
-Log in to Gel Cloud via the CLI:
+Log in to |Gel| Cloud via the CLI:
 
 .. code-block:: bash
 
   $ gel cloud login
 
 
 This will open a browser window and allow you to log in via GitHub.
-Now, create your Gel Cloud instance the same way you would create a
+Now, create your |Gel| Cloud instance the same way you would create a
 local instance:
 
 .. code-block:: bash
@@ -147,7 +147,7 @@ Full restore
 Questions? Problems? Bugs?
 ==========================
 
-Thank you for helping us make the best way to host your Gel instances even
+Thank you for helping us make the best way to host your |Gel| instances even
 better!
 
 * Please join us on `our Discord <https://discord.gg/umUueND6ag>`_  to ask

docs/reference-intro.rst

@@ -2,18 +2,18 @@
 Reference
 =========
 
-Learn three components, and you know Gel: how to work with
+Learn three components, and you know |Gel|: how to work with
 :ref:`schema <ref_datamodel_index>`, how to write queries with
 :ref:`EdgeQL <ref_edgeql>`, and what's available to you in our
-:ref:`standard library <ref_std>`. Start in those sections if you're new to Gel.
+:ref:`standard library <ref_std>`. Start in those sections if you're new to |Gel|.
 Move over to our :ref:`reference <ref_reference_index>` when you're ready to
 dive deep into the internals, syntax, and other advanced topics.
 
 
 Schema
 ------
 
-Gel schemas are declared using our schema definition language (SDL).
+|Gel| schemas are declared using our schema definition language (SDL).
 
 .. code-block:: sdl
 
@@ -74,7 +74,7 @@ shape with a link on an object as shown above.
 Standard library
 ----------------
 
-Gel comes with a rigorously defined type system consisting of scalar
+|Gel| comes with a rigorously defined type system consisting of scalar
 types, collection types (like arrays and tuples), and object types. It
 also includes a library of built-in functions and operators for working
 with each datatype, alongside some additional utilities and extensions.
@@ -121,7 +121,7 @@ with each datatype, alongside some additional utilities and extensions.
 Cheatsheets
 -----------
 
-Learn to do various common tasks using the many tools included with Gel.
+Learn to do various common tasks using the many tools included with |Gel|.
 
 Querying
 ^^^^^^^^