Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Split cloud API reference #929

Open
wants to merge 9 commits into
base: api
Choose a base branch
from

Conversation

kbatuigas
Copy link
Contributor

@kbatuigas kbatuigas commented Dec 17, 2024

Description

  • Separates the Cloud API reference out into a Control Plane API reference and Data Plane API reference
  • Updates related Rapidoc slots to ensure that the correct custom content is included in the split reference docs
    Resolves https://github.com/redpanda-data/documentation-private/issues/
    Review deadline: 31 Jan

Page previews

Control Plane API
Data Plane API

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

Copy link

netlify bot commented Dec 17, 2024

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 1e4fd94
🔍 Latest deploy log https://app.netlify.com/sites/redpanda-docs-preview/deploys/67940f1d6b0d740008ea0c11
😎 Deploy Preview https://deploy-preview-929--redpanda-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@JakeSCahill
Copy link
Contributor

We'll also need to go through all anchor links to api:ROOT:cloud-api.adoc and change them to go to either the data plane or control plane docs.


To familiarize yourself with Redpanda Cloud API basics, see the xref:redpanda-cloud:manage:api/cloud-api-overview.adoc[Redpanda Cloud API Overview]. To get started using the API, try the xref:redpanda-cloud:manage:api/cloud-api-quickstart.adoc[Quickstart].

NOTE: Redpanda Cloud uses a control plane and data plane architecture. To see the available endpoints for managing your clusters, networks, and resource groups, see the link:https://docs.redpanda.com/api/cloud-controlplane-api.html[Control Plane API Reference].
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@JakeSCahill I wasn't sure if I was supposed to use the .adoc extension for this link, so I kept it to .html just in case. Let me know if that should be changed

@kbatuigas
Copy link
Contributor Author

PR to update links: redpanda-data/cloud-docs#185

@weeco
Copy link
Contributor

weeco commented Jan 29, 2025

@kbatuigas (cc @mo-redpanda ), I feel like this separation is not prominent enough. It seems the only place where it's actually visible is, is in the breadcrumbs. As soon as you scroll a bit you'll immediately loose track of the fact that you are currently viewing the dataplane api. Therefore, I think this only solves a part of the problem.

If someone links you the List Users docs there's no immediate way to distinguish this "Users" API from the "Controlplane Users" for example

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants