Elastic Security Assistant initial docs (8.8.1)

[joepeeples]

Resolves #3420.

Preview: Security Assistant

Notes

• These docs are intended to be somewhat minimal, focusing on making sure readers know how to set up the Assistant and use some basic functionality. Further nuances of functionality, best practices, known issues, and so on will be expanded in future iterations (8.9 docs, etc.).

EDIT: removed Open Questions, which are now Answered Questions below.

[github-actions]

Documentation previews:

• ✨ HTML diff
• 📙 Elastic Security Guide

[jamesspi]

Hey @joepeeples

This is looking great! Perhaps we could squeeze in a quick gif?

To answer your Q's:

Is there an official name? How should it be used?
If the name is Elastic Security Assistant, is it OK to sometimes shorten to just Security Assistant?

We're going for Elastic Security Assistant for 8.8.1. It's fine to shorter in to Security Assistant.

Does the name include the, as in the Security Assistant?

I don't think it matters too much. Did you have a place In mind where you wanted to reference it as such?

[joepeeples]

@jamesspi:

Perhaps we could squeeze in a quick gif?

There are a couple of animated gifs in the page; I added them in the last commit so maybe you viewed the preview before CI had published that commit? But if you'd like another gif showing some other process, just let me know and we can figure it out.

I don't think it matters too much. Did you have a place In mind where you wanted to reference it as such ("the Security Assistant")?

I used "the Security Assistant" pretty consistently throughout the draft, so I was just confirming that's OK for now.

[nastasha-solomon]

Thanks for creating this @joepeeples! It's a great first iteration and I think it'll be helpful for getting users off the ground so they can tinker with the Security Assistant.

I left some suggestions for your consideration. Otherwise, it LGTM!

[jamesspi]

@jamesspi:

Perhaps we could squeeze in a quick gif?

There are a couple of animated gifs in the page; I added them in the last commit so maybe you viewed the preview before CI had published that commit? But if you'd like another gif showing some other process, just let me know and we can figure it out.

I don't think it matters too much. Did you have a place In mind where you wanted to reference it as such ("the Security Assistant")?

I used "the Security Assistant" pretty consistently throughout the draft, so I was just confirming that's OK for now.

@joepeeples Indeed, I see the gifs now, thanks!

[jmikell821]

Two comments for part 1 of feedback.

[jmikell821]

This is an awesome first iteration!!! Thanks @joepeeples ⭐

[spong]

Docs LGTM! 👍 Thanks so much @joepeeples! 😀

[jamesspi]

LGTM! 👍