Docs discrepancy in 'Change the index name' vs filebeat.reference.yml

[brsolomon-deloitte]

From https://www.elastic.co/guide/en/beats/filebeat/current/change-index-name.html#change-index-name:

output.elasticsearch.index: "customname-%{[agent.version]}"
setup.template.name: "customname"
setup.template.pattern: "customname-%{[agent.version]}"

From https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-reference-yml.html#filebeat-reference-yml (abridged):

output.elasticsearch:
  index: "filebeat-%{[agent.version]}"
setup.template.name: "filebeat-%{[agent.version]}"
setup.template.pattern: "filebeat-%{[agent.version]}"

There is a key difference here that is not explained by the docs. In the first example, the setup.template.name is not suffixed with the agent (filebeat) version, whereas in the second case, it is. As the agent versions are upgraded over time, this causes a difference in behavior where either (scenario 1) the same-named template is overwritten or (scenario 2) a new index template is created for each version.

Is it possible these two docs sources could be reconciled?

[elasticmachine]

Pinging @elastic/elastic-agent-data-plane (Team:Elastic-Agent-Data-Plane)

[botelastic]

Thank you very much for creating this issue. However, we would kindly like to ask you to post all questions and issues on the Discuss forum first. In addition to awesome, knowledgeable community contributors, core Beats developers are on the forums every single day to help you out as well. So, your questions will reach a wider audience there, and if we confirm that there is a bug, then you can reopen this issue with the new information or open a new one.

[brsolomon-deloitte]

https://discuss.elastic.co/t/docs-discrepancy-in-change-the-index-name-vs-filebeat-reference-yml/323152

[botelastic]

Hi!
We just realized that we haven't looked into this issue in a while. We're sorry!

We're labeling this issue as Stale to make it hit our filters and make sure we get back to it as soon as possible. In the meantime, it'd be extremely helpful if you could take a look at it as well and confirm its relevance. A simple comment with a nice emoji will be enough :+1.
Thank you for your contribution!