=====================
Support & Development
=====================

Mailing List
============

Questions about the SDK should be sent to its `Google Group`_.

.. _Google Group: https://groups.google.com/group/pythonforfacebook

Reporting Bugs
==============

Bugs with the SDK should be reported on the `issue tracker at Github`_. Bugs
with Facebook's Graph API should be reported on `Facebook's bugtracker`_.

.. _issue tracker at Github: https://github.com/pythonforfacebook/facebook-sdk/issues
.. _Facebook's bugtracker: https://developers.facebook.com/x/bugs/

Security Issues
---------------

Security issues with the SDK that would adversely affect users if reported
publicly should be sent through private email to the project maintainer at
martey @ marteydodoo.com (GPG key ID is 0x2cd700988f74c455).

Contributing
============

Use Github Pull Requests
------------------------

All potential code changes should be submitted as pull requests on Github. A
pull request should only include commits directly applicable to its change
(e.g. a pull request that adds a new feature should not include PEP8 changes in
an unrelated area of the code).

Code Style
----------

Code *must* be compliant with `PEP 8`_. Use the latest version of `pep8`_ or
`flake8`_ to catch issues.

Git commit messages should include `a summary and proper line wrapping`_.

.. _PEP 8: http://www.python.org/dev/peps/pep-0008/
.. _pep8: https://pypi.python.org/pypi/pep8
.. _flake8: https://pypi.python.org/pypi/flake8
.. _a summary and proper line wrapping: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html

Update Tests and Documentation
------------------------------

All non-trivial changes should include full test coverage. Please review
the package's documentation to ensure that it is up to date with any changes.

