Document new 3.0 features

[msullivan]

Already implemented features:

• errmessage on access policies (Report failing access policy #4529)
  • Doc v3 access policy errors #5220
• UUID to object cast (Cast uuid to object #4469)
  • Document UUID to object cast #5176
• json_object_pack (json_object_pack #4474)
  • Document json_object_pack #5154
• EXCEPT and INTERSECT (Add EXCEPT and INTERSECT set operators. #4631)
  • Document set intersect, except operators #5155
• Tuples in query arguments (Support passing tuples as arguments to queries #4489)
  • Document tuple parameters #5178
• MIGRATION REWRITE (Implement MIGRATION REWRITE system #4585)
  • Document migration rewrites #5290
• edgedb migration edit (2.1)
  • https://www.edgedb.com/docs/cli/edgedb_migration/edgedb_migration_edit
• RESET SCHEMA TO initial (Reset schema #4714)
  • Document reset schema to initial #5291
• Nested modules (Implement nested modules #4914)
  • Document nested modules #5153
• The assert function (Add an assert function to the standard library #5040)
  • Document assert #5237
• SDL syntax changes: just the "Updates to SDL" part of https://github.com/edgedb/rfcs/blob/master/text/1022-freetypes.rst (Implement the SDL syntax changes from RFC 1022 #4983)
  • Add new SDL syntax #5217
• Shape splats (RFC 1023, Implement support for splats (RFC 1023) #5080)
  • Document splats #5152
• Mutation rewrites: https://github.com/edgedb/rfcs/blob/master/text/1021-rewrites.rst (Implement mutation rewrites RFC #4937)
  • Document mutation rewrites #5324
• Triggers: https://github.com/edgedb/rfcs/blob/master/text/1020-triggers.rst (but not AFTER COMMIT OF)
  • Document triggers #5157
• Link properties on computed backlinks (Support link properties on computed backlinks #5227)
  • Document link property support on backlinks #5292
• Indexes: https://github.com/edgedb/rfcs/blob/master/text/1017-abstract-index.rst, https://github.com/edgedb/rfcs/blob/master/text/1018-extending-indexes.rst
  • Document PG indexes #5430
• New CLI features
  • Documentation for any of these that are not already released (like edgedb info --get) probably shouldn't be merged/deployed until final 3.0 release since the CLI docs are non-versioned. I will continue working on them and submit draft pull requests so they don't get merged before release and cause confusion. (We probably need some way to handle CLI documentation against server versions so things like this can go out alongside other documentation.)
  • edgedb watch
    • Document edgedb watch and new dev workflow #5342
  • edgedb migrate --dev-mode
  • edgedb migration upgrade-check
  • edgedb migration create --squash
  • edgedb analyze, \analyze, --expand
  • edgedb info --get (2.1)
  • --channel=testing, --to-testing in instance create, project init and cli upgrade
  • \d object xxx -> \d xxx maybe worth mentioning?

Delayed:

• Full text search: https://github.com/edgedb/rfcs/blob/master/text/1015-full-text-search.rst

I'm sure I'm missing some here. @raddevon, could you take point here?

[raddevon]

@msullivan I notice edgedb migration edit is on this list, but it already has documentation: https://www.edgedb.com/docs/cli/edgedb_migration/edgedb_migration_edit

Is there a new change as part of 3.0 that needs to be documented, or does the existing documentation still work?