Skip to content

Conversation

simon-dew
Copy link
Contributor

@simon-dew simon-dew commented Jul 30, 2025

Docs issue: AV-103170

This PR adds Data API references and examples to the Capella Developer docs, in most of the places where the Server Developer docs have Query REST API references and examples.

It does not include Data API references or examples in the "SQL++ Support for Couchbase Transactions" docs. Also, any Query Admin REST API references and examples are still hidden behind feature flags.

Additionally this PR fixes many links in the Capella Developer docs to point to Capella locations rather than Server. That's why there are so many files changed.

Docs preview (major updates only):

Credentials: Preview docs for internal review

This PR must be merged at the same time as:

@simon-dew simon-dew marked this pull request as ready for review July 31, 2025 10:40
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This example file was updated but does not appear in the published docs

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This example file was updated but does not appear in the published docs

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This partial was updated but does not appear in the published docs

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This page was updated, but references to the Data API are hidden behind the feature flag. Instead, a note is displayed in the published documentation saying that Couchbase Transactions are not supported via the Data API.

@simon-dew simon-dew force-pushed the AV-103170-query-api branch from fbdca84 to 9ea18a1 Compare October 7, 2025 09:44
@simon-dew simon-dew requested a review from a team October 7, 2025 22:07
Copy link
Contributor

@rakhi-prathap rakhi-prathap left a comment

Choose a reason for hiding this comment

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

Looks great! :)
Just a few small nits, but they're not blockers.

Comment on lines +363 to +365
////
use the {console-indexes}[Indexes page in the Capella UI] or
////
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
////
use the {console-indexes}[Indexes page in the Capella UI] or
////
// use the {console-indexes}[Indexes page in the Capella UI] or

The block comment (//// .. ////) seems to be adding extra space in the rendered output.
Can we change it to a line comment (//) instead so the formatting stays intact?

== Related Links

* An overview of scopes and collections is provided in {scopes-and-collections}[Scopes and Collections].
* An overview of scopes and collections is provided in {scopes-and-collections}[].
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* An overview of scopes and collections is provided in {scopes-and-collections}[].
* For an overview of scopes and collections, see {scopes-and-collections}[].

* An overview of scopes and collections is provided in {scopes-and-collections}[].

* Step-by-step procedures for management are provided in {manage-scopes-and-collections}[Manage Scopes and Collections].
* Step-by-step procedures for management are provided in {manage-scopes-and-collections}[].
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Step-by-step procedures for management are provided in {manage-scopes-and-collections}[].
* For step-by-step procedures for management, see {manage-scopes-and-collections}[].

* Step-by-step procedures for management are provided in {manage-scopes-and-collections}[].

* Refer to {scopes-and-collections-api}[Scopes and Collections API] to manage scopes and collections with the REST API.
* Refer to {scopes-and-collections-api}[Buckets, Scopes, and Collections] to manage scopes and collections with the Management API.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Refer to {scopes-and-collections-api}[Buckets, Scopes, and Collections] to manage scopes and collections with the Management API.
* To manage scopes and collections with the Management API, see {scopes-and-collections-api}[Buckets, Scopes, and Collections].

* Refer to {scopes-and-collections-api}[Buckets, Scopes, and Collections] to manage scopes and collections with the Management API.

* Refer to the reference page for the {couchbase-cli-collection-manage}[collection-manage] command to manage scopes and collections with the CLI.
* Refer to the {couchbase-cli-collection-manage}[Couchbase Shell Documentation] to manage scopes and collections with the Couchbase Shell.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Refer to the {couchbase-cli-collection-manage}[Couchbase Shell Documentation] to manage scopes and collections with the Couchbase Shell.
* To manage scopes and collections with the Couchbase Shell, see {couchbase-cli-collection-manage}[Couchbase Shell Documentation].

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.

2 participants