opensearch-project
[DOC] Requesting deprecation warning for legacy templates within Index templates documentation
What do you want to do?
- [x] 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.
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!
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.
Greetings! I found this issue while searching for any documentation for when legacy templates will be fully removed.
