Welcome to PyPy's documentation!
================================

Welcome to the documentation for PyPy, a fast_, compliant alternative
implementation of the Python_ language.

* If you want to find out more about what PyPy is, have a look at our :doc:`introduction`
  or consult the `PyPy website`_.

* If you're interested in trying PyPy out, check out the :doc:`installation instructions <install>`.

* If you want to help develop PyPy, please have a look at :doc:`contributing <contributing>` and at the repo on https://foss.heptapod.net/pypy/pypy
  and get in touch (:ref:`contact`)!

All of the documentation and source code is available under the MIT license,
unless otherwise specified. Consult :source:`LICENSE`.

.. _fast: https://speed.pypy.org
.. _Python: https://python.org/
.. _PyPy website: https://pypy.org/


.. _getting-started-index:

Getting Started
---------------

.. toctree::
  :maxdepth: 1

  introduction
  architecture
  install
  build
  windows
  faq


.. _using-pypy:

Using PyPy
----------

.. toctree::
  :maxdepth: 2

  cpython_differences
  extending
  gc_info
  jit-hooks
  stackless
  __pypy__-module
  sandbox
  stm

Development
-----------

.. toctree::
  :maxdepth: 2

  contributing
  configuration
  project-ideas
  project-documentation
  how-to-release


Further resources
-----------------

.. toctree::
  :maxdepth: 1

  index-of-release-notes
  index-of-whatsnew
  contributor
  glossary

.. _contact:

Contact
-------

`#pypy on irc.freenode.net`_
    Many of the core developers are hanging out here. You are welcome to join
    and ask questions (if they are not already answered in the :doc:`FAQ
    <faq>`). You can find logs of the channel here_.

`Development mailing list`_
    Development and conceptual discussions

`Commit mailing list`_
    Updates to code and documentation

`Development bug/feature tracker`_
    Filing bugs and feature requests

Meeting PyPy developers
    The PyPy developers are organizing sprints and presenting results at
    conferences all year round. They will be happy to meet in person with
    anyone interested in the project. Watch out for sprint announcements on
    the `development mailing list`_.

Twitter handle `#pypyproject`_

Watch us on twitch_

.. _#pypy on irc.freenode.net: irc://irc.freenode.net/pypy
.. _here: https://quodlibet.duckdns.org/irc/pypy/latest.log.html#irc-end
.. _Development mailing list: https://mail.python.org/mailman/listinfo/pypy-dev
.. _Commit mailing list: https://mail.python.org/mailman/listinfo/pypy-commit
.. _Development bug/feature tracker: https://foss.heptapod.net/pypy/pypy/issues
.. _`#pypyproject`: https://twitter.com/pypyproject
.. _twitch: https://www.twitch.tv/pypyproject

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
