Expand filebased user for recovering security

[stefnestor]

Refactors filebased realm page for clarity & expands examples to include file-based role.yml definitions needed to recovering security.

Relates #2479

[stefnestor]

👋 @elastic/admin-docs , I did try to figure out the links myself from Brandon's earlier guidance but apparently could use more help, sorry 🙂🙏

[shainaraskas]

I think that the information about recovering security does not necessarily belong in this doc. while the file might need to be refactored, introducing this information and the role information blows up the scope of the page. the recovery use case might work better as a standalone tutorial.

[shainaraskas]

see comment

[stefnestor]

Thanks, @shainaraskas ! And apologies for delay on my side. I have ported into a troubleshooting guide (with some minor edits left on first page). 🙏

[shainaraskas]

generally looks really good. I've edited the recovery tutorial a little for grammar and flow

questions:

• is the person always going to need the allow_restricted_indices permission? should we guide them when they should/should not use it?
• can we give them next steps, e.g. testing of this user, recovery tasks ...?

let me know how badly I butchered things with my edits

[github-actions]

🔍 Preview links for changed docs

• troubleshoot/elasticsearch/file-based-recovery.md
• deploy-manage/users-roles/cluster-or-deployment-auth/file-based.md
• troubleshoot/elasticsearch.md

[shainaraskas]

link fix suggestions

[shainaraskas]

if dev is happy we're good to merge

[tvernum]

Overall this looks good and is a very welcome addition. I had a few minor suggestions to make the wording more accurately reflect the how the underlying features work.