Fix links/refs in js docs (#8378)

docs/clients/js/queries.rst

@@ -271,11 +271,9 @@ To exclude the generated files, add the following lines to your ``.gitignore`` f
 Writing Queries with Parameters
 -------------------------------
 
-To inject external values into your EdgeQL queries, you can use `parameters </docs/edgeql/parameters>`__.
+To inject external values into your EdgeQL queries, you can use :ref:`parameters <ref_eql_params>`.
 
 When using the queries generator, you may be tempted to declare the same parameter in multiple places.
-However, it's better practice to declare it once by assigning it to a variable in a `with block </docs/edgeql/with#query-parameters>`__
+However, it's better practice to declare it once by assigning it to a variable in a :ref:`with block <ref_eql_with_params>`
 and reference that variable in the rest of your query. This way you avoid mismatched types in your declarations,
-such as forgetting to mark them all as `optional </docs/edgeql/parameters#optional-parameters>`__.
-
-Check out the `EdgeQL docs </docs/edgeql/index>`__ to learn more about writing queries.
+such as forgetting to mark them all as :ref:`optional <ref_eql_params_optional>`.

docs/clients/js/select.rst

@@ -638,7 +638,7 @@ fact that they will only occur in certain objects.
 Detached
 --------
 
-Sometimes you need to "detach" a set reference from the current scope. (Read the `reference docs <ref_edgeql_with_detached>`_ for details.) You can achieve this in the query builder with the top-level ``e.detached`` function.
+Sometimes you need to "detach" a set reference from the current scope. (Read the :ref:`reference docs <ref_edgeql_with_detached>` for details.) You can achieve this in the query builder with the top-level ``e.detached`` function.
 
 .. code-block:: typescript
 

docs/edgeql/parameters.rst

@@ -125,6 +125,8 @@ properties.
    };
 
 
+.. _ref_eql_params_optional:
+
 Optional parameters
 -------------------
 

docs/edgeql/with.rst

@@ -60,6 +60,7 @@ Avengers.
     ...
   }
 
+.. _ref_eql_with_params:
 
 Query parameters
 ^^^^^^^^^^^^^^^^