Django New Project Structure/Name

Using Django Getting Started
6

Bumping: PR issued!

I’ve also settled on config over the years, and have issued a PR to make the startproject template follow this convention. I’ve taught Django to well over 100 newcomers, and it is alarmingly frequent how confusing have two directories with the same name can be:

  • my_project at the root
  • my_project/my_project for configuration.

I can’t tell you how many times I’ve said, “Okay switch into the ‘my_project’ directory - no, the other one! The one with manage.py / settings.py!”

I think config is the right choice. settings is already taken by settings.py in the default project, and conf isn’t as explicit an abbreviation as config (conf is often used for conference).

Ticket: #33650 (Update startproject template with config directory) – Django (djangoproject.com)
WIP PR: Refs #33650: Changes to the startproject template by FlipperPA · Pull Request #15609 · django/django (github.com)