Add clarifications and fix typographical errors

Description

Based on review by , and others, various fixes are needed to improve the clarity of the current 1.0.0 spec, separately from addressing its semantic shortcomings.

Activity

Show:
Pablo Pazos
November 14, 2019, 10:47 PM

Did the review of the current AQL v1.0.0 spec and reported issues here:

Thomas reviewed the document and added comments / priorities.

I made some fixes based on Thomas' feedback, this is the working branch for those:

I’ll add some more fixes to the text before sending the first PR to review (to avoid sending too much changes on the same PR)

Pablo Pazos
February 25, 2020, 10:08 PM

Second set of changes committed on this PR

Matija Polajnar
April 10, 2020, 5:03 AM
Edited
  • Hex integers are → Hexadecimal representation is

  • Specification encourages use of extended ISO-8601 format, but the first example is in basic format; I propose adding an example with a full date-time in extended format as the first example, which will be the one that gets copied&pasted by lazy people.

  • predicates in `class expressions`: further filters for data in the subset (could be transformed into predicates for the `WHERE` clause): I’m not sure you can express an archetype predicate in WHERE

 

Done

Reporter

Thomas Beale

Raised By

Pablo Pazos

Components

Affects versions

Configure