Skip to content

Add docs for the new API keys provisioning role - #7564

Open
yetanothertw wants to merge 12 commits into
mainfrom
api-keys-provisioning-1260
Open

Add docs for the new API keys provisioning role#7564
yetanothertw wants to merge 12 commits into
mainfrom
api-keys-provisioning-1260

Conversation

@yetanothertw

@yetanothertw yetanothertw commented Jul 24, 2026

Copy link
Copy Markdown
Member

Summary

Closes #1260 Adds details about a new role that allows a member to generate workload credentials to the Elastic Cloud API keys page.

Reviewer SMEs: @/nathalie-tran and @/s-nel + @/alxchalkias

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

Comment thread deploy-manage/users-roles/cloud-organization/manage-users.md Outdated
Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated
@yetanothertw
yetanothertw requested a review from alxchalkias July 24, 2026 11:31
@yetanothertw

Copy link
Copy Markdown
Member Author

Thanks @alxchalkias, I've updated the language to be slightly more generic wrt to workload credentials. It's ready for your review again.

Comment thread deploy-manage/api-keys/elastic-cloud-api-keys.md Outdated
Co-authored-by: Samuel Nelson <samuel.nelson@elastic.co>

@shainaraskas shainaraskas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

some thoughts on copy and positioning for you

Comment thread deploy-manage/api-keys/elastic-cloud-api-keys.md Outdated
Comment thread deploy-manage/api-keys/elastic-cloud-api-keys.md Outdated
Comment thread deploy-manage/api-keys/elastic-cloud-api-keys.md
Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated
Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated
Comment thread deploy-manage/api-keys/elastic-cloud-api-keys.md
@yetanothertw

Copy link
Copy Markdown
Member Author

some thoughts on copy and positioning for you

Thank you, @shainaraskas -- much appreciated since all these concepts are so new to me. Please have another go at it when you get the chance.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

here, we need to say the person can allow the key to manage workload credentials (it's not a role) :)

(I think this is a thing)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

It's difficult to tell from the current designs (which cover the Invite members page/path), but I'd imagine a similar solution like toggling on an option to allow users to manage workload credentials would apply in this case.

I'll need to check this after feature freeze.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Oh I totally misread that comment. Added ✅ Thank you!

Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated
Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated
Comment thread deploy-manage/users-roles/cloud-organization/user-roles.md Outdated

@shainaraskas shainaraskas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think we are still relying too much on the existing structure of these pages - manage workload credentials is consistently slotted into role-related sections

@shainaraskas shainaraskas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

lgtm, thanks <3

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.

4 participants