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

[DOCS] Move and expand saved object conflict resolution example #82

Open
lcawl opened this issue Oct 18, 2024 · 0 comments
Open

[DOCS] Move and expand saved object conflict resolution example #82

lcawl opened this issue Oct 18, 2024 · 0 comments

Comments

@lcawl
Copy link
Contributor

lcawl commented Oct 18, 2024

Description

As part of the migration of API reference information to https://www.elastic.co/docs/api/doc/kibana, we're retiring the old manually-maintained pages. However, per elastic/kibana#195333 (comment), the example about a failed attempt to copy saved objects with conflict errors needs more explanation than seems appropriate for the new format.

Therefore, IMO the https://www.elastic.co/guide/en/kibana/8.15/spaces-api-copy-saved-objects.html#spaces-api-copy-saved-objects-example-3 example should instead be moved and expanded within the narrative docs. For example, perhaps https://www.elastic.co/guide/en/kibana/8.15/managing-saved-objects.html#managing-saved-objects-copy-to-space should be expanded to cover the types of errors you might encounter (in both the UI and API, I'm assuming) and how to resolve them. Or perhaps that's more appropriate for a separate troubleshooting page.

Resources

N/A

Which documentation set does this change impact?

Elastic On-Prem only

Feature differences

The api/spaces/_copy_saved_objects endpoint doesn't seem to exist in the list of Kibana Serverless APIs at this time (per https://www.elastic.co/docs/api/doc/serverless/group/endpoint-saved-objects) though I haven't tested whether the UI can nonetheless encounter conflict errors.

What release is this request related to?

8.16

Collaboration model

The documentation team

Point of contact.

Stakeholders:

@elena-shostak

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

No branches or pull requests

1 participant