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
- Related to #32692 (closed) (Rename WIP merge requests to Draft)
- Related to #231502 (closed) (Replace all instances of "WIP" to "draft" in GitLab docs)