[DOC] Requesting deprecation warning for legacy templates within Index templates documentation

[r1walz]

What do you want to do?

• Request a change to existing documentation
• Add new documentation
• Report a technical problem with the documentation
• Other

Tell us about your request. Provide a summary of the request and all versions that are affected.

Index Templates (templatesV2; ep: /_index_template) documentation should mention deprecation warning about the previous gen templates v1 (ep: /_template) API.

While _cat/templates list down both legacy as well as Index templates, there are separate APIs for interacting with both. Having a deprecation warning can help users to identify the differences between the information provided by _cat/templates and /_index_template/*.

Long time systems may still be using legacy templates, new users onboarding to them may find it difficult to dig through the existence of legacy templates, creating confusion. (I'm unable to find any documentation on our docs page for legacy templates).

What other resources are available? Provide links to related issues, POCs, steps for testing, etc.

There are no easily available resources to look for this discrepancy.

[samipak458]

@Naarcha-AWS I would like to contribute on this.

[hdhalter]

Hi @r1walz - Are you still planning to work on this? Thanks.

[r1walz]

Hi, @hdhalter. I believe @samipak458 picked it up earlier. If it is not scheduled under his plan then feel free to pick it up yourself. Thanks!

[hdhalter]

Hi, @hdhalter. I believe @samipak458 picked it up earlier. If it is not scheduled under his plan then feel free to pick it up yourself. Thanks!

I am only triaging, but yes, I tagged the wrong person! Let's see if @samipak458 picks it up.

[drewmiranda-gl]

Greetings! I found this issue while searching for any documentation for when legacy templates will be fully removed.