Philosophy

We have a few guiding principles about Elastic. 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. They are implemented as required, but I might make a few mistakes on the way. 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.