Include tips on how to develop with docker

[WoosterInitiative]

One question that I haven't seen answered in the docs is how to do development using Docker, specifically how to handle migrations. There is a note about running migrate in the container, but no guidance on how to create the migrations (using makemigrations).

From what I've gathered, "best practice" would be to install Django on the dev machine and run python -m manage makemigrations and only then run the migrate command in the container.

I'm happy to create the PR for this, but I wanted to make sure that there is some agreement that this is the "right" way to do this?

[browniebroke]

There is a note about running migrate in the container, but no guidance on how to create the migrations (using makemigrations).

The section you're referring to is titled "Execute Management Commands", and makemigrations is a management command. There is nothing special about it, you can use the same as the other examples: docker-compose -f local.yml run --rm django python manage.py makemigrations

In local development, the whole codebase is mounted as volume:

cookiecutter-django/{{cookiecutter.project_slug}}/local.yml

Lines 22 to 23 in fbc2373

	volumes:
	- .:/app:z

Which means that migration files created in a container should appear on your host machine.