Space Awareness: Update Fleet roles and privileges UI docs

[karenzone]

Related:

• [REQUEST]: Space awareness ingest-docs#1142
• Headstart from @kilfoyle's work in Space Awareness: Document updates to Fleet's roles and privileges UI ingest-docs#998.

PREVIEW: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/1751/reference/fleet/fleet-roles-privileges

[github-actions]

🔍 Preview links for changed docs:

• reference/fleet/fleet-roles-privileges.md

🔔 The preview site may take up to 3 minutes to finish building. These links will become live once it completes.

[karenzone]

cc:/ @benironside FYI: Here's a WIP draft of the Fleet UI side of Space Awareness.
Let's talk about how we can collaborate to do this feature up right.

[karenzone]

Observation on output:: List item 10-1 is numbered as a.. List items 10-2 and 10-3 are numbered as 2. and 3.

Maybe the <br>s I added to increase space after the graphics are throwing numbering off? Interesting that the correct interval is preserved (a, 2, 3), but not the numbering/lettering style.

[karenzone]

Update: After I removed the <br>s, the sub-steps are numbering correctly (a, b, c) in a local build. Do we have other tools for forcing better spacing available?

[vishaangelova]

If you indent the image blocks by 4 spaces to be within each step, maybe that could change the rendering a bit and add more space? (I should try this out, I guess)

[vishaangelova]

Formatting it like below renders the images within the a-b-c list with the correct numbering, also keeping the last two paragraphs indented (as part of step 10, but not part of step c). But it doesn’t solve the spacing issue, I guess.

Not using <br> looks OK to me though. (The screenshot is only of the last sub-step as the images were too large (does it make sense to resize them?).

10. Choose the access level that you'd like the role to have with respect to {{fleet}} and integrations:
    1. To grant the role full access to use and manage {{fleet}} and integrations, set both the **Fleet** and **Integrations** privileges to `All`.

        :::{image} images/kibana-fleet-privileges-all.png
        :alt: Kibana privileges flyout showing Fleet and Integrations access set to All
        :screenshot:
        :::

    2. To create a read-only user for {{fleet}} and Integrations, set both the **Fleet** and **Integrations** privileges to `Read`.

        :::{image} images/kibana-fleet-privileges-read.png
        :alt: Kibana privileges flyout showing Fleet and Integrations access set to All
        :screenshot:
        :::

    3. If you'd like to define more specialized access to {{fleet}} based on individual components, expand the **Fleet** menu and enable **Customize sub-feature privileges**.

        :::{image} images/kibana-fleet-privileges-enable.png
        :alt: Kibana customize sub-feature privileges UI
        :screenshot:
        :::

    Any setting for individual {{fleet}} components that you specify here takes precedence over the general `All`, `Read`, or `None` privilege set for {{fleet}}.
    
    Based on your selections, access to features in the {{fleet}} UI are enabled or disabled for the role. 
    Those details are covered in the next section: [Customize access to {{fleet}} features](#fleet-roles-and-privileges-sub-features).

After you've created a new role you can assign it to any {{es}} user.
You can edit the role at any time by returning to the **Roles** page in {{kib}}.

[kilfoyle]

LGTM! 🦖
Very nice!

[nimarezainia]

LGTM thank you. just one minor comment about the version.

[nimarezainia]

version should be 9.1

[nimarezainia]

@karenzone I will need to add some content regarding migration. for an existing deployment with agent policies there's an extra step they have to perform before the feature can be enabled. Once your changes are merged I'll make the mods. thanks

[karenzone]

@karenzone I will need to add some content regarding migration. for an existing deployment with agent policies there's an extra step they have to perform before the feature can be enabled. Once your changes are merged I'll make the mods. thanks

Thanks, @nimarezainia. I'll make a note to be on the lookout for incoming changes post-merge.

[vishaangelova]

If you indent the image blocks by 4 spaces to be within each step, maybe that could change the rendering a bit and add more space? (I should try this out, I guess)

[karenzone]

@kpollich, here's the Space Awareness PR we talked about.
Thanks for your help with it.

[juliaElastic]

Looks great!

[karenzone]

@colleenmcginnis, here's the PR we talked about wrt versioning for layered content. Let's discuss, please.

[colleenmcginnis]

@karenzone Based on a quick review, I would expect something like this to clarify what's available in which version.

My suggestions are meant to be illustrative — you'll likely need to adjust my suggestions based on the knowledge you've gained working on this issue (that I certainly don't have!).

[colleenmcginnis]

✨ Looks good!

I left one question below in case it's something I missed before.