## DRI @cfeick ## Participants * @abignotti * @vwolanyk * @mwoolf ## Problem Statement In Deploy experimental documentation for #261+, the API Platform team delivered an experimental deployment of GitLab's REST API documentation using OpenAPI 3.0 and Scalar. The outcome of that epic validated the problem solution and technical approach, however, it does not yet meet quality standards for a public launch. This epic tracks the work to deliver a production-ready deployment that launches as a **Public Beta**: continuously deployed, secure, performant, and publicly available. The legacy API documentation remains available during the beta. Rather than a single cut-over, docs.gitlab.com links out prominently to the Public Beta, and the remaining Markdown docs are redirected to the new site progressively. Full replacement of the legacy documentation, and the GA declaration, are follow-on work informed by beta feedback and usage metrics. Note: API documentation rendered by Scalar is intentionally _not_ packaged for self-managed instances, so does not have to go through the PREP process. ## Exit Criteria * **Infrastructure**: production-ready continuous deployments, performance, observability * **User experience**: branding parity, live API testing, multi-version support * **Stakeholders**: AppSec and Technical Writing approvals, Public Beta announced * **Public Beta launch**: api.gitlab.com/rest publicly live and clearly labelled Beta, docs.gitlab.com linking out prominently to it, remaining Markdown docs redirected over time, usage metrics and a feedback channel in place ## Out of Scope (post-beta / GA) * Retiring the legacy Markdown API documentation * Completing the redirect of every remaining Markdown page * The GA declaration itself ## Development Log <!-- STATUS NOTE START --> ## Status 2026-09-17 Everything the team can do has been done! Now only the work from the Technical Writing team remains. :tada: **achievements**: * The Technical Writing team is organizing 50+ MRs that bring over to GitLab's OpenAPI specification the information on ~2000 parameters and routes that is currently sitting in docs :issue-blocked: **blockers**: * :arrow_forward: **next**: * Open the MRs, complete the review process for them and get them merged _Copied from https://gitlab.com/groups/gitlab-org/quality/-/epics/402#note_3846633242_ <!-- STATUS NOTE END -->