All contributions are welcome: ideas, patches, documentation, bug reports, complaints, etc!
Programming is not a required skill, and there are many ways to help out! It is more important to us that you are able to contribute.
That said, some basic guidelines, which you are free to ignore :)
Want to write your own code to do something Curator doesn't do out of the box?
- Curator API Documentation Since version 2.0, Curator ships with both an API and wrapper scripts (which are actually defined as entry points). This allows you to write your own scripts to accomplish similar goals, or even new and different things with the Curator API, es_client, and the Elasticsearch Python Client Library.
Want to know how to use the command-line interface (CLI)?
- Curator CLI Documentation The Curator CLI Documentation is now a part of the document repository at http://elastic.co/guide at http://www.elastic.co/guide/en/elasticsearch/client/curator/current/index.html
- File a ticket on github
If you think you found a bug, it probably is a bug.
- File it on github
If you have a bugfix or new feature that you would like to contribute to Curator, and you think it will take more than a few minutes to produce the fix (ie; write code), it is worth discussing the change with the Curator users and developers first! You can reach us via github.
Documentation is in two parts: API and CLI documentation.
API documentation is generated from comments inside the classes and methods within the code. This documentation is rendered and hosted at http://curator.readthedocs.io
CLI documentation is in Asciidoc format in the GitHub repository at https://github.com/elastic/curator/tree/master/docs/asciidoc. This documentation can be changed via a pull request as with any other code change.
- Test your changes! Run the test suite ('pytest --cov=curator'). Please note
that this requires an Elasticsearch instance. The tests will try to connect
to a local elasticsearch instance and run integration tests against it.
This will delete all the data stored there! You can use the env variable
TEST_ES_SERVERto point to a different instance (for example 'otherhost:9203'). - Please make sure you have signed our Contributor License Agreement. We are not asking you to assign copyright to us, but to give us the right to distribute your code without restriction. We ask this of all contributors in order to assure our users of the origin and continuing existence of the code. You only need to sign the CLA once.
- Send a pull request! Push your changes to your fork of the repository and submit a pull request. In the pull request, describe what your changes do and mention any bugs/issues related to the pull request.