Incremental Delivery spec draft

At a glance

• Identifier: #1110
• Stage: RFC1: Proposal
• Champion: @robrichard
• PR: Incremental Delivery spec draft

Timeline

• Added to 2024-11-07 WG agenda
• Commit pushed: Add examples to Response section on 2024-11-01 by @robrichard
• Added to 2024-10-03 WG agenda
• Mentioned in 2024-10 WG notes
• Spec PR created on 2024-09-18 by robrichard
• 2 commits pushed on 2024-09-18:
  • Add Response Section for defer/stream (#4) by @robrichard
  • Add directives and validation sections (#5) by @robrichard
• 7 commits pushed on 2024-09-06:
  • adjust heading by @yaacovCR
  • Initialize graph by @yaacovCR
  • adjust YieldSubsequentResults algorithm per review by @yaacovCR
  • reuse GetIncrementalResult() for the error case by @yaacovCR
  • add descriptions and fix bug within GetNewRootNodes, it needs the old… by @yaacovCR
  • finish addressing review comments by @yaacovCR
  • add missing word by @yaacovCR
• Commit pushed: add subheadings on 2024-09-05 by @yaacovCR
• 3 commits pushed on 2024-08-26:
  • Correct argument name by @yaacovCR
  • clarify errors from ExecuteExecutionPlan by @yaacovCR
  • add initial versions of explanations for the algorithms in the "Execu… by @yaacovCR
• 3 commits pushed on 2024-07-25:
  • add missing arguments by @yaacovCR
  • add missing return value by @yaacovCR
  • fix some renaming around CollectExecutionGroups and ExecuteExecutionG… by @yaacovCR
• Commit pushed: path => label on 2024-07-24 by @yaacovCR
• Commit pushed: rename FieldPlan to ExecutionPlan on 2024-07-20 by @yaacovCR
• 5 commits pushed on 2024-07-18:
  • properly initialize deferUsages with their parents by @yaacovCR
  • move Field Collection back to where it was by @yaacovCR
  • f by @yaacovCR
  • use fieldDetailsList consistently by @yaacovCR
  • add info re: data structures by @yaacovCR
• 3 commits pushed on 2024-07-17:
  • bring BuildFieldPlan in line with implementation by @yaacovCR
  • rename "deferred grouped field set record" to "execution group" by @yaacovCR
  • rename ExecuteExecutionGroup to CollectExecutionGroup by @yaacovCR
• 5 commits pushed on 2024-06-19:
  • fix timing by @yaacovCR
  • reuse function by @yaacovCR
  • fix by @yaacovCR
  • rename BuildGraph to GraphFromRecords by @yaacovCR
  • reword recursive abort case by @yaacovCR
• 2 commits pushed on 2024-06-18:
  • add a word or two about which child nodes are being promoted by @yaacovCR
  • be more graphy by @yaacovCR
• Commit pushed: refactor a few lines out of YieldSubsequentResults on 2024-06-13 by @yaacovCR
• 2 commits pushed on 2024-02-15:
  • moves Field Collection section earlier by @yaacovCR
  • Introduce `@defer` directive by @yaacovCR
• Commit pushed: Correct reference to MergeSelectionSets on 2023-08-21 by @benjie
• 2 commits pushed on 2023-04-28:
  • Extract common logic from ExecuteQuery, ExecuteMutation and ExecuteSu… by @benjie
  • Change ExecuteSelectionSet to ExecuteGroupedFieldSet by @benjie

---

Spec draft of @defer based on the response format in https://github.com/graphql/defer-stream-wg/discussions/69, with no duplication of fields. @stream will be added soon.

Please keep discussion limited to specifics on how the spec text is written. There is a dedicated discussion forum for questions, feedback, and comments on defer & stream: https://github.com/graphql/defer-stream-wg/discussions