=================
Developer's Guide
=================

.. toctree::
   :maxdepth: 3
   :hidden:

   CONTRIBUTING
   ci_setup
   how_to_release

This discusses information relevant to developing Py-ART.

--------
Versions
--------
Py-ART follows `semantic versioning <https://semver.org>`_ in its version number. This means
that any Py-ART ``1.x`` release will be backwards compatible with an earlier ``1.y`` release. By
"backward compatible", we mean that **correct** code that works on a ``1.y`` version will work
on a future ``1.x`` version. It's always possible for bug fixes to change behavior or make
incorrect code cease to work. Backwards-incompatible changes will only be allowed when changing
to version ``2.0``. Such changes will be proceeded by `FutureWarning` as appropriate.
For a version ``1.x.y``, we change ``x`` when we release new features, and ``y``
when we make a release with only bug fixes.