source/developer/contributing.rst

2 Contributing to Numba
5 We welcome people who want to make contributions to Numba, big or small!
16 Numba uses Gitter for public real-time chat.  To help improve the
19 * `numba/numba <https://gitter.im/numba/numba>`_: General Numba discussion,
34 Numba uses Discourse as a forum for longer running threads such as design
48 The core Numba developers have a weekly video conference to discuss roadmap,
51 `Numba wiki <https://github.com/numba/numba/wiki/Meeting-Minutes>`_.
63 * which operating system you have and which version of Numba you are running;
64 * how Numba is misbehaving, e.g. the full error traceback, or the unexpected
87 Numba has a number of dependencies (mostly `NumPy <http://www.numpy.org/>`_
105    choose another version supported by Numba.  To test additional features,
129 Building Numba
132 For a convenient development workflow, we recommend you build Numba inside
141 C files inside the Numba source tree.
146 Numba is validated using a test suite comprised of various kind of tests
151 running Numba from a source checkout, you can type ``./runtests.py``
190 When debugging, it is useful to turn on logging.  Numba logs using the
224 Numba uses `Flake8 <http://flake8.pycqa.org/en/latest/>`_ to ensure a consistent
226 with ``pip`` or ``conda`` and then run from the root of the Numba repository::
240 from the root of the Numba repository. Now ``flake8`` will be run each time
243 Numba has started the process of using `type hints <https://www.python.org/dev/peps/pep-0484/>`_ in…
256 There is potential for confusion between the Numba module ``typing`` and Python built-in module ``t…
257 hints, as well as between Numba types---such as ``Dict`` or ``Literal``---and ``typing`` types of t…
275 platforms Numba supports.  This includes ARMv7, ARMv8, POWER8, as well as both
283 with, feel free to ask for help in your pull request.  The Numba core developers
290 The Numba documentation is split over two repositories:
293   `Numba repository <https://github.com/numba/numba>`_.
295 * The `Numba homepage <http://numba.pydata.org>`_ has its sources in a
302 This documentation is under the ``docs`` directory of the `Numba repository`_.
317 Core developers can upload this documentation to the Numba website
328 The Numba homepage on http://numba.pydata.org can be fetched from here: