Add more examples to the documentation

[MalfuncEddie]

Currently the examples are very limited and mostly limited to search examples. The documentation should be improved to add examples for:
elasticsearch.client.IndicesClient.put_mapping
https://elasticsearch-py.readthedocs.io/en/latest/api.html?highlight=mapping#elasticsearch.client.IndicesClient.put_mapping
https://elasticsearch-py.readthedocs.io/en/master/api.html?highlight=watcher#elasticsearch.client.WatcherClient

Background: just updated my ES 7 to 8 and the python client scripts I had no longer work. After several hours plowing through the documentation I just gave up

[ezimuel]

@MalfuncEddie we will consider to improve the documentation. Do you have any proposal for a use case?
Moreover, can you share an error log for the issue that you found moving from ES 7 to 8? Did you check the Migrating to 8.0 documentation page?

[MalfuncEddie]

I think even most of de documentation could be automated. The thing is you have a great example at the beginning how to connect to ES and I think that the same examples could be needed elsewhere.

simple examples like:

from elasticsearch import Elasticsearch
import json

es =  Elasticsearch(
    "http://localhost:9200",
    api_key=("id", "api_key")
)

if es.ping():
    print('Yay Connect')
else:
    print('Awww it could not connect!')
	
role = "rolename"
roles = ["user"]
rules = {"field" : { "username" : "*" }}'
json_rules = json.loads (rules)
es.security.put_role_mapping(name=role, enabled=enabled,roles=roles, rules=json_rules)
es.close()