quickly add field(s) to existing Django models with South

Add field to an existing Django app with South

====================================================================
Simple-as-possible instructions to add a field (or more) using South 
to an existing Django model with existing data.
====================================================================

Two versions:
  1. Super-condensed (the bare minimum - jfdi)
  2. Detailed-but-brief (if you want more information).

Notes:
  [appname] is a placeholder for the name of your Django app.
  South works separately on each application, not on a whole project.
  Commands are in backticks: `command here`


====================================================================
1. Super-condensed instructions:
   (you already know your way around, but are new to South)

`sudo easy_install South`

add 'south' to INSTALLED_APPS
`./manage.py syncdb`
`./manage.py convert_to_south [appname]`

add new field(s)
`./manage.py schemamigration [appname] --auto`
`./manage.py migrate [appname]`

see the new field in your Django project admin.


====================================================================
2. Detailed-but-brief instructions:
   (if you want more details)

1. get South with: `sudo easy_install South` (note capital 'S')

2. add 'south' to your project's INSTALLED_APPS in settings.py (note small 's')
  (test the install: `./manage.py shell` then `import south` - no message=good!)

3. type: `./manage.py syncdb`
  (make South migration-tracking tables)

4. type: `./manage.py convert_to_south [appname]`
  (shortcut for --initial followed by a migrate --fake)

5. add the field to your model
   - unless you pre-populate it with default data, it needs both
     null=True, blank=True
     to be empty in the database and for Django admin validation.

6. type: `./manage.py schemamigration [appname] --auto`

7. type: `./manage.py migrate [appname]`

8. You can now use the new field and view it in your Django admin.

Thanks, been trying to find instructions on this.

This is very useful. Thank You for posting gist sir 👍

Thanks for this excellent manual!

This was an excellent set of instructions. Thanks again !!!

Simple yet short. Thanks