CONTRIBUTING.rst

Contributing to Astroquery

The first official release of astroquery occurred in September 2013.

Please see astropy's contributing guildelines for a general guide to the workflow involving git, etc. Everything below is astroquery-specific.

New Features

We welcome any and all new features! If you have your own little query tool you wrote to access some obscure service, feel free to clean it up a little and submit it as a pull request (PR)! However, we'll ask you to at least write some simple tests and do your best to get the API to match the astroquery API.

Tests are welcome and encouraged, but can be built up over time. At least one example use is necessary for a new module to be accepted.

The template module should be the starting point for any new contribution. It includes detailed explanations of each function and class and can straightforwardly be filled out.

As shown in the template module, the minimum requirements for a new feature are:

• Add the feature as a subdirectory of astroquery with at least an __init__.py and a core.py:

  astroquery/feature
  astroquery/feature/__init__.py
  astroquery/feature/core.py
  

• Add a tests/ directory with at least one test:

  astroquery/feature/tests
  astroquery/feature/tests/__init__.py
  astroquery/feature/tests/test_feature.py
  

• Add some documentation - at least one example, but it can be sparse at first:

  docs/astroquery/feature.rst
  

PRs will not be accepted if tests fail.