This PR contains the easiest changes to make to Easy EdgeDB in response to Devon's excellent feedback that he put together while reading Easy EdgeDB for the first time. EdgeDB itself is in flux at the moment so this PR addresses the lowest lying fruit that can be taken care of in the meantime. The commits go in roughly the same order as Devon's reader feedback.
Some highlights:
Lots of suggested rewordings and grammar fixes
Some changes to schema types and functions
Changing keywords to lowercase throughout
Some happy rewrites where EdgeDB has functionality that it did not have before (e.g. a cal::local_date used to give an error for pre-Unix epoch dates such as the 19th century dates in the book, but this is no longer the case)
Overall structure remains the same and the book does not yet guide the reader through each schema migration that takes place per chapter (or sometimes multiple migrations inside a single chapter) or address issues where some objects have been deleted in one chapter and queried in the next, or where random objects (the Kains and the Billies and all the other non-book characters) have been inserted and end up appearing in later queries. This will happen in a later PR devoted to using the EdgeDB Projects tools and migration flow. In the meantime, this PR includes a caveat that the content on migration is still out of date in places and some exhortations to use the new tools + UI, and removes the commands in the schema such as start migration to to avoid confusion and nudge the reader in the direction of the project tools.
This PR contains the easiest changes to make to Easy EdgeDB in response to Devon's excellent feedback that he put together while reading Easy EdgeDB for the first time. EdgeDB itself is in flux at the moment so this PR addresses the lowest lying fruit that can be taken care of in the meantime. The commits go in roughly the same order as Devon's reader feedback.
Some highlights:
Overall structure remains the same and the book does not yet guide the reader through each schema migration that takes place per chapter (or sometimes multiple migrations inside a single chapter) or address issues where some objects have been deleted in one chapter and queried in the next, or where random objects (the Kains and the Billies and all the other non-book characters) have been inserted and end up appearing in later queries. This will happen in a later PR devoted to using the EdgeDB Projects tools and migration flow. In the meantime, this PR includes a caveat that the content on migration is still out of date in places and some exhortations to use the new tools + UI, and removes the commands in the schema such as
start migration toto avoid confusion and nudge the reader in the direction of the project tools.