Philosophy

Elastic has a few guiding principles. Those are not set in stone, but provide general guidance.

1. Elasticsearch has many many features, roughly 100 endpoints and 600 JSON structures at the time of writing this. In Elastic, they are implemented as required with a preference for search/indexing instead of administration. However, Elastic might not implement and support all of them. Forgive me.
2. I love pull requests. I really do. However, please read the contribution guidelines first. When implementing an API endpoint, make it complete, and provide tests.
3. Elasticsearch: The Definite Guide is a nice introduction to Elasticsearch in general (buy the book). The official documentation doesn't cover all subtleties, but is rather good, too.
4. The official JSON API specification is your friend. Use it. When in doubt, consult the Java API and its source code.
5. I try to follow the best practices of the official Elasticsearch clients. They are build on robust principles. Thank you guys for working out all those details.