instructions on how to translate REST framework error messages

docs/topics/internationalisation.md

@@ -0,0 +1,34 @@
+# Internationalisation
+REST framework ships with translatable error messages. You can make these appear in your language enabling [Django's standard translation mechanisms](https://docs.djangoproject.com/en/1.7/topics/i18n/translation) and by translating the messages into your language.
+
+## How to translate REST Framework errors
+
+
+This guide assumes you are already familiar with how to translate a Django app. If you're not, start by reading [Django's translation docs](https://docs.djangoproject.com/en/1.7/topics/i18n/translation).
+
+
+#### To translate REST framework error messages:
+
+1. Pick an app where you want the translations to be, for example `myapp`
+
+2. Add a symlink from that app to the installed `rest_framework`
+  ```
+  ln -s /home/user/.virtualenvs/myproject/lib/python2.7/site-packages/rest_framework/ rest_framework
+  ```
+  
+  To find out where `rest_framework` is installed, run 
+
+  ```
+  python -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())"
+  ```
+
+3. Run Django's `makemessages` command in the normal way, but add the `--symlink` option. For example, if you want to translate into Brazilian Portuguese you would run
+  ```
+  manage.py makemessages --symlink -l pt_BR
+  ```
+  
+4. Translate the `django.po` file which is created as normal. This will be in the folder `myapp/locale/pt_BR/LC_MESSAGES`.
+
+5. Run `manage.py compilemessages` as normal
+
+6. Restart your server