Skip to content

GraphQL updates to remove WIP in favor of Draft

#32692 (closed) introduced the draft term in order to replace WIP. However, the API still uses the term as part of the API, as @aqualls noted in #231502 (closed) for documentation work.

The deprecation process for GraphQL (https://docs.gitlab.com/ee/api/graphql/#deprecation-process) says a 6-month timeline is required between change and removal, but I'm not sure if that clock started with #32692 (closed) or if it starts with this issue landing.

Users have commented on API inconsistency and I am unsure if that comment has been addressed.

I know more scoping work is undoubtedly needed, so I'm passing this issue over to @m_gill and cc'ing @phikai.

Identified pages with problems

  • doc/user/project/quick_actions.md - was the /wip quick action updated? (This may need to be a separate issue)
  • doc/development/api_graphql_styleguide.md - contains code examples that discuss WIP-related mutations. This doc should be updated by an engineer; your technical writer (Amy) can review it afterward
  • doc/api/graphql/reference/index.md - contains two sections of work: the definitions (which Amy is comfortable modifying) and the API itself. Those changes should originate from an engineer, not a TW.

As an aside, review #32692 (comment 457051366) to see if bugs still need to be filed?

Related issues