33 Matching Annotations
  1. Mar 2024
    1. TypeQL is flexible enough that we could certainly do so if we wanted, but it is not particularly useful to and there are certain practical considerations that make the syntax tricky to use correctly. While learning the basics of TypeQL, it is best to avoid relates statements of this kind.

      instead of saying it's dangerous, can you saying something more concrete? (and less dramatic sounding :-D )

    1. If you see this result, you’ve set up everything correctly and are ready to begin learning how to read data in Lesson 3.

      I think it would be super useful to explain "Running a code selection" as well on this page (with screenshots). Otherwise, they'll have create a new file for each query.

    1. Parametric polymorphism

      prob rewrite intro paragraph. see individual comments.

      I'd rewrite this section which a focus on parametric statements. then "parametric query" can be a derived notation.

      Examples of parametric statements: $x sub relation; $y has $a; $b ($a) isa $T;

    2. The defining feature of parametric statements is that they do not include any type names, except for the root type keywords entity, relation, and attribute

      i would change this definition (I'm sure this won't impact the rest too much): the defining property is that they contain type variables that can potentially range over multiple inheritance hierarchies or interface implementations. Really, the feature to communicate is that we can have type variables! Of course, this is often implicitly, for example, match $x isa book; book owns $T; $a isa $T; $x has $a; could be match $x isa book, has $a; I'd rewrite this section which a focus on parametric statements. tbd

    3. Parametric queries do not represent questions in the business domain, and are typically used to perform administrative procedures or database analytics.

      this should come a bit later? after the examples?

    4. Parametric queries are unique in that they are valid over any schema.

      not true since queries can parametric in some type but not another. i see no need to interpret "parametric queries" this strictly.

    5. in the schema that

      are you saying somewhere that we will leave the schema implicit for now? otherwise the user may wonder where "the schema" is that you are referring to.

      (also structurally ambiguous usage of "that")

    6. querying their supertypes, as

      i feel like the following is missing: subtype of a supertype is more special that then the supertype, conversely, a supertype is the generalization of (maybe many) subtypes.

    7. m. In the following query, we adjust the previous query to retrieve the titles and page counts of all books.

      Explain the relation of book with the other types, don't to say "supertype" but sth is needed.