docs: remove observability adapter API specs and source from the openchoreo repo

[akila-i]

Purpose

The logs, metrics, and tracing adapter OpenAPI specs now live in the openchoreo repo under openapi/. Point the SwaggerUI references at the raw spec URLs there and drop the vendored copies from static/api-specs/ so the openchoreo repo is the single source of truth.

Adapter API specs were moved to openchroeo repo via following PRs
openchoreo/openchoreo#3843
openchoreo/openchoreo#3847
openchoreo/openchoreo#3848
openchoreo/openchoreo#3849
openchoreo/openchoreo#3851

Related Issues

openchoreo/openchoreo#3842

Checklist

• Updated sidebars.ts if adding a new documentation page
• Run npm run start to preview the changes locally
• Run npm run build to ensure the build passes without errors
• Verified all links are working (no broken links)

[coderabbitai]

📝 Walkthrough

Walkthrough

Three local OpenAPI YAML spec files (observability-logs-adapter-api.yaml, observability-metrics-adapter.yaml, observability-tracing-adapter-api.yaml) are deleted from static/api-specs/. The SwaggerUI specUrl in the three corresponding MDX documentation pages is updated from local /api-specs/ paths to GitHub raw content URLs pointing to the upstream openchoreo repository.

Changes

Observability Adapter API Spec Migration

Layer / File(s)

Summary

SwaggerUI specUrl redirected to GitHub raw URLs docs/platform-engineer-guide/modules/observability-logging-adapter-api.mdx, docs/platform-engineer-guide/modules/observability-metrics-adapter-api.mdx, docs/platform-engineer-guide/modules/observability-tracing-adapter-api.mdx, static/api-specs/observability-logs-adapter-api.yaml, static/api-specs/observability-metrics-adapter.yaml, static/api-specs/observability-tracing-adapter-api.yaml

The three local OpenAPI YAML spec files (798, 920, and 439 lines respectively) are removed from static/api-specs/, and each MDX page's SwaggerUI specUrl is switched to the corresponding raw GitHub URL in the openchoreo repository.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related issues

• move observability adapter openapi specs from docs repo to openchoreo repo openchoreo#3842: This PR directly implements the migration described in that issue — removing the observability adapter OpenAPI specs from the docs repository and redirecting documentation to reference specs hosted on GitHub raw content from the openchoreo repository.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description check	✅ Passed	The description covers the purpose, related issues, and includes a checklist matching the template, though one link verification item remains incomplete.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title accurately describes the main change: removing vendored observability adapter API specs and sourcing them from the openchoreo repository instead.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sameerajayasoma]

How does this work for different versions of OpenChoreo?

[akila-i]

specUrl is modified in versioned docs to point to the corresponding release branch