document schema_editor.connection.alias

The ticket https://code.djangoproject.com/ticket/23749 explains the issue where the ```schema_editor.connection.alias``` should be documented.  It is now documented with some examples included.
I'd rather replace this specific logic with a placeholder like
```
# Migration logic
...
```