Skip to content

[Doc] Add doc pages for cross-cluter API key APIs#96415

Merged
ywangd merged 5 commits intoelastic:mainfrom
ywangd:rcs-docs-for-new-apis
Jun 8, 2023
Merged

[Doc] Add doc pages for cross-cluter API key APIs#96415
ywangd merged 5 commits intoelastic:mainfrom
ywangd:rcs-docs-for-new-apis

Conversation

@ywangd
Copy link
Member

@ywangd ywangd commented May 30, 2023

This PR adds API doc pages for the new create and update cross-cluster API key APIs.

Relates: #95714, #96085

This PR adds API doc pages for the new create and update cross-cluster
API key APIs.

Relates: elastic#95714, elastic#96085
@github-actions
Copy link
Contributor

Documentation preview:

++++

TODO: Placeholder
Creates an API key of the `cross_cluster` type for the API key based remote cluster access.
Copy link
Member Author

Choose a reason for hiding this comment

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

Once we add relevant docs for "API key based remote cluster model", we can link to it from here to give more context. For now, this remains to be just plain text.

Comment on lines +39 to +40
} else {
systemProperty 'tests.rest.blacklist', ['*/create-cross-cluster-api-key/*', '*/update-cross-cluster-api-key/*']
Copy link
Member Author

Choose a reason for hiding this comment

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

Skip the new pages for doc test in release build since they are still behind feature flag.

@ywangd ywangd added >docs General docs changes :Security/Security Security issues without another label labels May 30, 2023
@ywangd ywangd marked this pull request as ready for review May 30, 2023 06:00
@ywangd ywangd requested a review from alaudazzi May 30, 2023 06:00
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Security Meta label for security team labels May 30, 2023
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-security (Team:Security)

Copy link
Contributor

@alaudazzi alaudazzi left a comment

Choose a reason for hiding this comment

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

Left a few editing suggestions, otherwise LGTM.

ywangd and others added 2 commits June 7, 2023 12:36
Co-authored-by: Arianna Laudazzi <46651782+alaudazzi@users.noreply.github.com>
…asciidoc

Co-authored-by: Arianna Laudazzi <46651782+alaudazzi@users.noreply.github.com>
@ywangd
Copy link
Member Author

ywangd commented Jun 7, 2023

@elasticmachine update branch

@ywangd ywangd merged commit 3c95735 into elastic:main Jun 8, 2023
elasticsearchmachine pushed a commit that referenced this pull request Jul 24, 2023
The syntax requires a comma separated string instead of a list.

Relates: #96415 Resolves: #97871
ywangd added a commit to ywangd/elasticsearch that referenced this pull request Jul 24, 2023
The syntax requires a comma separated string instead of a list.

Relates: elastic#96415 Resolves: elastic#97871
elasticsearchmachine pushed a commit that referenced this pull request Jul 24, 2023
The syntax requires a comma separated string instead of a list.

Relates: #96415 Resolves: #97871
jrodewig pushed a commit that referenced this pull request Jul 24, 2023
Relates to elastic/docs#2722, #96415

This PR provides a work-around for the following doc build broken links:

```
13:40:21 INFO:build_docs:Bad cross-document links:
13:40:21 INFO:build_docs:  /tmp/docsbuild/target_repo/html/en/elasticsearch/client/javascript-api/8.9/api-reference.html contains broken links to:
13:40:21 INFO:build_docs:   - en/elasticsearch/reference/8.9/security-api-create-cross-cluster-api-key.html
13:40:21 INFO:build_docs:   - en/elasticsearch/reference/8.9/security-api-update-cross-cluster-api-key.html
13:40:21 INFO:build_docs:  /tmp/docsbuild/target_repo/html/en/elasticsearch/client/javascript-api/current/api-reference.html contains broken links to:
13:40:21 INFO:build_docs:   - en/elasticsearch/reference/8.9/security-api-create-cross-cluster-api-key.html
13:40:21 INFO:build_docs:   - en/elasticsearch/reference/8.9/security-api-update-cross-cluster-api-key.html
```
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes :Security/Security Security issues without another label Team:Docs Meta label for docs team Team:Security Meta label for security team v8.9.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants