[DOCS] Combo version of ILM docs.

[debadair]

The goal is to present a more user-friendly, holistic view of the management features like ILM. This PR reworks the ILM content in the ES ref to show the UI as the primary way of setting up ILM. It incorporates the ILM tutorial that currently is published in the Kibana guide. Once this combined content is published, we'll remove the redundant content from the Kibana guide, set up redirects where needed, and add xrefs to the the ES docs.

Preview: https://elasticsearch_57909.docs-preview.app.elstc.co/guide/en/elasticsearch/reference/master/index-lifecycle-management.html

[debadair]

@elasticmachine retest this please

[elasticmachine]

Pinging @elastic/es-core-features (:Core/Features/ILM+SLM)

[elasticmachine]

Pinging @elastic/es-docs (>docs)

[dakrone]

@debadair I don't understand, why do we have the same tutorial duplicated in two places? Is there no way to link or refer to it? I'm concerned that since it's duplicated it means a higher chance of the two diverging at some point in the future

[debadair]

@debadair I don't understand, why do we have the same tutorial duplicated in two places? Is there no way to link or refer to it? I'm concerned that since it's duplicated it means a higher chance of the two diverging at some point in the future

It's temporary. It will be removed from the Kibana guide/repo & maintained here going forward.

[dakrone]

LGTM

[jrodewig]

It looks like these two files are nearly identical:

• docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc
• docs/reference/ilm/example-index-lifecycle-policy.asciidoc

I didn't notice until later in my review, but it looks like only docs/reference/ilm/example-index-lifecycle-policy.asciidoc is actually rendering. Please copy any of my applicable comments over.

Broader food for thought:

• This PRs adds a decent number of PNG images. If we take this strategy forward, I imagine that number will grow. However, from what I understand, storing binary files in GitHub generally isn't good practice and can lead to bandwidth suffering as the repo grows and images change. It may be worth considering a workaround for that.

• We don't indicate to the user that we expect Kibana to be installed or point them to a place where they can do that. While it may not be worth doing on every tutorial, we may want to add a note somewhere to indicate that the docs expect the user to have Kibana running.

[gchaps]

I like how the Kibana UIs were included in the docs.

In overview-index-lifecycle-management , the formatting of Rollover bullet needs fixing.

[lockewritesdocs]

Left a few comments. Will look at this again with fresh eyes after feedback from other reviewers is addressed.

[debadair]

It looks like these two files are nearly identical:

• docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc
• docs/reference/ilm/example-index-lifecycle-policy.asciidoc

They are identical. The docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc file is an artifact of my attempts to preserve its history. The first one needs to be removed.

[jrodewig]

LGTM. Still confused over the duplicate files, but if that gets addressed I'm good with these changes. Missed your comment. Thanks for the explanation!

[debadair]

• We don't indicate to the user that we expect Kibana to be installed or point them to a place where they can do that. While it may not be worth doing on every tutorial, we may want to add a note somewhere to indicate that the docs expect the user to have Kibana running.

It probably makes sense to have a "management" topic that addresses this that we can link to. I'll address that separately.