Skip to content

Deferred: v1.15.1 Omnigraph promotion + resolutions docs (post blue→prod) #2223

@shrugs

Description

@shrugs

Tracking the follow-up docs PR to land after #2214 merges and after the blue environment is promoted to production. Split out of #2214 review feedback (@lightwalker-eth) so that PR can stay scoped to the quickstart/concepts cleanup.

This PR will:

  • Mark v1.15.1 as the active Omnigraph version; delete the now-stale v1.13.1 walkthrough content.
  • Align all Omnigraph docs/examples with the API going live in the blue environment.
  • Add resolutions support to the docs (feature @sevenzing demoed):
    • A "hello world" resolution in the quickstart walkthrough.
    • Feature resolution-related footguns on the Omnigraph overview — complexities of the params for "raw" resolutions, and parsing / validating / interpreting "raw" resolution results.
    • Pull in @sevenzing's prepared demo example queries as inspiration.
  • Add a Core Concepts section on handling both ENSv1 and ENSv2 response shapes: building on the Omnigraph makes an app ENSv2-ready, but devs must prepare their code to handle receiving both ENSv1 and ENSv2 Domains in responses, or the app breaks at ENSv2 launch (per @lightwalker-eth's note on the overview page).
  • Add an inline comment in the quickstart highlighting the benefit of the beautified value.

Coordination: @shrugs + @sevenzing to align on getting the resolutions PR deployed to blue, and to have this docs PR ready to merge the moment production switches to blue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions