Adding a note about not using configured component templates from API-created index templates

[masseyke]

Right now, Elasticsearch does not allow you to pull a component template created in a configuration policy into an index template created through the API. This has the potential to be dangerous to users, so I'm adding a note to the documentation. This will hopefully be fixed in elastic/elasticsearch#118594, and at that point we can change this note to only refer to versions before that one.

[akashsingh-aps]

I am unable to find the updated documentation as per this PR.
IIUC it is supposed to be here: https://www.elastic.co/docs/deploy-manage/deploy/cloud-on-k8s/elastic-stack-configuration-policies

Am I missing something ? 🤔

@masseyke Would you mind confirming, where this PR got merged and released ?

[masseyke]

This note was removed a month later by this change: #8496. I'm still trying to figure out where the documentation went.

[masseyke]

@eedugon do you know where the content that was formerly in docs/orchestrating-elastic-stack-applications/stack-config-policy.asciidoc went after #8496, so that we can add this note back?

[eedugon]

@masseyke : After the migration to the new docs V3 system, the majority of ECK docs have been moved to docs-content repository.

Some other docs (reference documentation, release notes, etc) are still in cloud-on-k8s repo, but in markdown format and not in asciidoc anymore.

The legacy asciidoc docs are still in this repo but only in the old 2.x branches.

So, answering your question:

• The new doc associated with the legacy doc you updated in this PR is https://www.elastic.co/docs/deploy-manage/deploy/cloud-on-k8s/elastic-stack-configuration-policies. The actual file should be deploy-manage/deploy/cloud-on-k8s/elastic-stack-configuration-policies.md on docs-content repository. You can also click on edit this page in the public document and you will get redirected directly to the exact place.

I'm very sorry if we missed this message while migrating the docs!

For some reason I cannot even see the note in the 2.16 legacy version of the docs: https://www.elastic.co/guide/en/cloud-on-k8s/2.16/k8s-stack-config-policy.html --> Maybe we also need to apply this PR there again.

[eedugon]

@akashsingh-aps , this is a very good finding. Next time don't hesitate pinging us directly in the internal docs slack channel, or opening a new issue in docs-content asking about the missing content ;)

I've created elastic/docs-content#2823 to fix the issue in the new docs.

And also #8815 to add the note in 2.16 docs.

[akashsingh-aps]

Ack and Thanks @eedugon .

Appreciate your assistance also in addressing this @masseyke .