[8.19] move language examples to a separate file (#4910)

[pquentin]

Backport

This will backport the following commits from main to 8.19:

• move language examples to a separate file (#4910)

Questions ?

Please refer to the Backport tool documentation

[github-actions]

Following you can find the validation changes against the target branch for the APIs.

API	Status	Request	Response
cat.aliases	🟢	29/29 → 30/30	29/29 → 30/30
cat.component_templates	🟢 → ⚪	3/3 → Missing test	3/3 → Missing test
cat.shards	🟢	16/16 → 11/11	16/16 → 11/11
cluster.allocation_explain	🟢	6/6 → 4/4	6/6 → 4/4
cluster.get_component_template	🟢	12/12 → 10/10	12/12 → 10/10
cluster.health	🟢	207/207 → 178/178	207/207 → 178/178
cluster.put_component_template	🔴	32/36 → 24/34	36/36 → 34/34
cluster.reroute	🟢	8/8 → 7/7	7/7 → 6/6
cluster.state	🟢	83/83 → 81/81	82/82 → 80/80
connector.delete	🟢	29/29 → 9/9	29/29 → 9/9
connector.get	🟢	64/64 → 60/60	64/64 → 60/60
connector.list	🟢	31/31 → 19/19	31/31 → 19/19
connector.put	🟢	20/20 → 14/14	20/20 → 14/14
esql.query	🟢	323/323 → 315/315	0/0
ilm.explain_lifecycle	🔴 → 🟢	5/5	4/5 → 5/5
indices.add_block	🟢	3/3 → 2/2	3/3 → 2/2
indices.analyze	🟢 → 🔴	246/246 → 244/245	246/246 → 245/245
indices.create	🔴	1302/1336 → 1219/1287	1336/1336 → 1287/1287
indices.create_data_stream	🟢	118/118 → 116/116	118/118 → 116/116
indices.delete	🟢	114/114 → 113/113	114/114 → 113/113
indices.delete_alias	🔴	12/12 → 15/15	5/12 → 5/15
indices.exists_alias	🟢	37/37 → 38/38	37/37 → 38/38
indices.flush	🟢	50/50 → 49/49	50/50 → 49/49
indices.forcemerge	🟢	14/14 → 13/13	14/14 → 13/13
indices.get_alias	🟢 → 🔴	75/75 → 89/89	75/75 → 80/89
indices.get_data_stream	🔴	119/119 → 115/115	75/119 → 17/115
indices.get_field_mapping	🟢	26/26 → 18/18	26/26 → 18/18
indices.get_index_template	🟢	21/21 → 11/11	21/21 → 11/11
indices.get_mapping	🔴	213/213 → 200/200	203/213 → 183/200
indices.get_template	🟢	32/32 → 30/30	32/32 → 30/30
indices.put_alias	🔴	60/60 → 61/61	20/60 → 20/61
indices.put_index_template	🔴	126/149 → 111/143	149/149 → 143/143
indices.put_mapping	🔴	140/143 → 128/140	146/146 → 143/143
indices.refresh	🟢	313/313 → 293/293	313/313 → 293/293
indices.rollover	🔴	54/54 → 52/52	2/54 → 2/52
indices.stats	🔴	125/125 → 115/115	30/124 → 30/114
ingest.simulate	🟢	12/12 → 10/10	12/12 → 10/10
ml.get_calendar_events	🟢 → 🔴	15/15	15/15 → 5/15
ml.get_trained_models	🟢	36/36 → 37/37	36/36 → 37/37
ml.post_calendar_events	🟢 → 🔴	12/12	12/12 → 0/12
nodes.info	🟢	116/116 → 114/114	116/116 → 114/114
nodes.stats	🔴	58/58 → 51/51	18/58 → 15/51
query_rules.put_ruleset	🟢	17/17 → 16/16	17/17 → 16/16
search_application.get	🔴	10/10	7/10 → 6/10
search_application.put	🔴	6/10 → 3/10	10/10
security.authenticate	🔴 → 🟢	30/30	25/30 → 30/30
security.bulk_put_role	🟢 → 🔴	1/1 → 0/1	1/1
security.create_service_token	🟢	2/2 → 3/3	2/2 → 3/3
security.put_role	🟢 → 🔴	39/39 → 32/39	38/38
snapshot.create	🟢	30/30 → 29/29	30/30 → 29/29
snapshot.delete	🟢	24/24 → 23/23	24/24 → 23/23
snapshot.get	🟢	16/16 → 13/13	16/16 → 13/13
synonyms.delete_synonym_rule	🟢	8/8 → 7/7	8/8 → 7/7
synonyms.get_synonyms_sets	🟢	7/7 → 6/6	7/7 → 6/6
synonyms.put_synonym	🟢	32/32 → 28/28	32/32 → 28/28
synonyms.put_synonym_rule	🟢	5/5 → 4/4	5/5 → 4/4
watcher.ack_watch	🟢	6/6 → 1/1	6/6 → 1/1
watcher.activate_watch	🟢	3/3 → 1/1	3/3 → 1/1
watcher.deactivate_watch	🟢	3/3 → 1/1	3/3 → 1/1
watcher.delete_watch	🟢	11/11 → 2/2	11/11 → 2/2
watcher.execute_watch	🔴 → 🟢	41/62 → 7/7	8/62 → 7/7
watcher.get_settings	🟢 → ⚪	4/4 → Missing test	4/4 → Missing test
watcher.get_watch	🔴 → 🟢	46/46 → 9/9	43/46 → 9/9
watcher.put_watch	🔴	75/91 → 29/38	91/91 → 38/38
watcher.query_watches	🔴 → ⚪	1/1 → Missing test	0/1 → Missing test
watcher.start	🟢	3/3 → 1/1	3/3 → 1/1
watcher.stats	🟢	7/7 → 1/1	7/7 → 1/1
watcher.stop	🟢	2/2 → 1/1	2/2 → 1/1
watcher.update_settings	🔴 → ⚪	0/3 → Missing test	3/3 → Missing test
xpack.usage	🔴	43/43 → 40/40	1/39 → 2/36

You can validate these APIs yourself by using the make validate target.