<commit_before>Miscellaneous
=============

Mailing list
------------

Join to `django-social-auth discussion list`_ and bring any questions or suggestions
that would improve this application.


South users
-----------

South_ users should add this rule to enable migrations::

    try:
        import south
        from south.modelsinspector import add_introspection_rules
        add_introspection_rules([], ["^social_auth\.fields\.JSONField"])
    except:
        pass


Custom User model
-----------------

If defining a custom user model, do not import ``social_auth`` from any
``models.py`` that would finally import from the ``models.py`` that defines
your ``User`` class or it will make your project fail with a recursive import
because ``social_auth`` uses ``get_model()`` to retrieve your User.


Third party backends
--------------------

There's an ongoing movement to create a list of third party backends on
djangopackages.com_, so, if somebody doesn't want it's backend in the
``contrib`` directory but still wants to share, just split it in a separated
package and link it there.


Python 2.7.2rev4, 2.7.3 and Facebook backend
-------------------------------------------

Seems that this bug described in StackOverflow_ hits users using
django-social-auth_ with Python versions 2.7.2rev4 and 2.7.3 (so far) and
Facebook backend. The bug report `#315`_ explains it a bit more and shows
a workaround fit avoid it.
<commit_msg>remove unnecessary South documentation, fix typos<commit_after>Miscellaneous
=============

Mailing list
------------

Join to `django-social-auth discussion list`_ and bring any questions or suggestions
that would improve this application.


Custom User model
-----------------

If defining a custom user model, do not import ``social_auth`` from any
``models.py`` that would finally import from the ``models.py`` that defines
your ``User`` class or it will make your project fail with a recursive import
because ``social_auth`` uses ``get_model()`` to retrieve your User.


Third party backends
--------------------

There's an ongoing movement to create a list of third party backends on
djangopackages.com_, so, if somebody doesn't want its backend in the
``contrib`` directory but still wants to share, just split it in a separated
package and link it there.


Python 2.7.2rev4, 2.7.3 and Facebook backend
-------------------------------------------

It seems that this bug described in StackOverflow_ hits users using
django-social-auth_ with Python versions 2.7.2rev4 and 2.7.3 (so far) and
Facebook backend. The bug report `#315`_ explains it a bit more and shows
a workaround fit to avoid it.

{'fraction_non_alphanumeric': 0.14231642694928084, 'fraction_numerical': 0.012869038607115822, 'mean_word_length': 3.0351145038167937, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6679222', 'n_tokens_mistral': 702, 'n_tokens_neox': 658, 'n_words': 337}