Skip to content

Commit

Permalink
Details about simple scoping
Browse files Browse the repository at this point in the history
  • Loading branch information
scotttrinh committed Dec 18, 2024
1 parent ced4921 commit 465966f
Showing 1 changed file with 17 additions and 5 deletions.
22 changes: 17 additions & 5 deletions docs/changelog/6_x.rst
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ upgrade more frequently.
Query performance observability
-------------------------------

We now store statistics about query performance. [explain more here]
We now store statistics about query performance.

``ext::postgis``
----------------
Expand Down Expand Up @@ -192,12 +192,24 @@ We've introduced several new features to our authentication extension:
Simpler scoping rules
---------------------

We've simplified the scoping rules [explain more here].
We've simplified the scoping rules for queries. See `our RFC 1027 outlining the
changes <https://github.com/edgedb/rfcs/blob/master/text/1027-no-factoring.rst>`_.

UI improvements
---------------
To quote from the RFC:

- Schema diffs
> The desire to remove path factoring comes from two directions: a desire to
> simplify and improve the language, and from implementation concerns.
>
> The path factoring behavior is quite complex, and makes it difficult to
> understand the behavior of a query at a glance. Furthermore, it badly
> compromises several of the intended design principles of EdgeQL.
>
> EdgeQL aims to support a "top-to-bottom" reading, but path factoring means
> that code later in the query can fundamentally alter the meaning.

By default in 6.0, we will generate new schemas that opt-in to the new scoping
rules. Existing schemas will continue to use the old rules and emit warnings
when queries that trigger the old behavior are encountered at query time.

Additional changes
==================
Expand Down

0 comments on commit 465966f

Please sign in to comment.