Skip to content

Add ability to report server version to the changelog #269

@DillonSadofsky

Description

@DillonSadofsky

Context

Apollo studio has a really great graphql schema diff tool at https://studio.apollographql.com/graph/<graph_name>/variant/<variant_name>/changelog
We use it for our internal dev variants and production variants (deployments). I often point third party developers at a deployed variant as a place where they can view a readme, explore schema, and prototype queries in the sandbox.

That said, the changelog notes additions/subtractions by date, but in all correspondence, we refer to what was added or removed by server/schema semver version #. Our clients often take version updates on different dates, or even in bulk, so this takes time and effort to 'map' to our version #'s when in communication with the user.

The readme mentions version control, but I can't find anything in the GraphOS or apollo studio docs about having a version # reported in a first party way. I figure I can 'fake' this by having an endpoint whose 'name' is the version and then the changelog would show -version.5_0 and +version.6_0 but that feels pretty hacky. I assume there has to be a better way?

What type of feedback is this?

  • Question
  • Idea
  • Bug
  • New example or operation collection

Is there anything else you'd like to share about the Platform API?

No

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions