ingest: raise visibility of ingest plugin documentation

[jakelandis]

part of #33188

• adds a processor plugin link from the main reference
• moves set security user to main documentation
• updates x-pack security doc to point to main documenation

---

Updated processor page

Updated x-pack/stack doc

EDIT: updated description to match latest PR
EDIT2: updated description to match latest PR

[elasticmachine]

Pinging @elastic/es-core-infra

[jakelandis]

requesting @eskibars review based on #33188 (comment)

[rjernst]

This seems like the wrong place to mention the set user processor, as it is not installed as a normal plugin; it comes with the default distribution. The others must be installed as normal elasticsearch plugins.

[jakelandis]

This seems like the wrong place to mention the set user processor

good point ! Let me try something different... adding WIP label.

[jakelandis]

Latest attempt to raise visibility of the Set Security User Processor is to move the documentation for it to primary documentation.

This works because it is now part of the default distribution and will just work if security is setup. I included an IMPORTANT section to help ensure that it is obvious that an authenticated user is required, which by inference means this only works with the default distribution.

@lcawl @eskibars - could I get your opinion on adding this documentation to the main documentation that is dependent on security enabled + default distribution ?

[lcawl]

Moving this content makes sense to me. I submitted two minor suggestions, but think it would be good for @debadair to weigh in on the Elasticsearch table of contents.

[debadair]

@jakelandis Agree that moving the Set security user processor into the list of ingest processors makes sense.

I'm less sure about adding the "Plugin Processors" topic after the Processors topic. I would be inclined to add that information to the top level Processors topic. I think the point you're trying to make is that there are the built-in processors described under Processes and additional ingest processors that can be installed as ES plugins? If so, I'd be inclined to add the folliowing section to the bottom of the Processors page:

[float]
=== Ingest Processor Plugins

Additional ingest processors can be implemented and installed as Elasticsearch {plugins}/intro.html[plugins]. See {plugins}/ingest.html[Ingest plugins] for information about the available ingest plugins.

That way, people aren't confused about the difference between "Processors" and "Plugin Processors" and (hopefully) will avoid an extra click.

[jakelandis]

@lcawl @debadair thanks for the reviews ! changes as requested made, and screen shots of the rendered output are updated in the description.

[lcawl]

@jakelandis I ran the documentation builds and the changes look good to me.

[debadair]

LGTM, thanks!

[eskibars]

LGTM!