Django Dev Environment Setup Inaccurate
- Dominant language
- Markdown
- Stars
- 11k
- Forks
- 23.2k
- Avg merge
- 2d 9h
- Merged PRs (30d)
- 331
Description
### MDN URL
https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Server-side/Django/development_environment
### What specific section or headline is this issue about?
https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Server-side/Django/development_environment
### What information was incorrect, unhelpful, or incomplete?
The virtual environment set up section, at least for Ubuntu/Linux, is all wrong. Python3 INCLUDES a virtual environment. Trying to follow the instructions as given results in an error regarding installs, and encourages people to edit a file they really shouldn't be editing unless absolutely necessary. Also that wrapper isn't tested with any version of python newer than 3.11, when at this time we're on 3.13.
Additionally, the linked Django docs seem to be for Django 5.0, which Django themselves state is insecure and unsupported. (That said, said docs do use python3's included tool rather than a separate wrapper)
### What did you expect to see?
Instructions that did not have errors, out of date links, and weird requests to mess with files that are better left alone, especially when python3 already has its own virtual environment.
### Do you have any supporting links, references, or citations?
Link to the quick install given by the article: https://docs.djangoproject.com/en/5.0/intro/install/
Link to the python3 docs explaining venv: https://docs.python.org/3/library/venv.html
Link to explainer I found regarding an error with the wrapper I encountered: https://www.pythontutorials.net/blog/how-do-i-solve-error-externally-managed-environment-every-time-i-use-pip-3/
Link to wrapper documentation linked with the article that states python versions its tested with (not the latest): https://virtualenvwrapper.readthedocs.io/en/latest/install.html
### Do you have anything more you want to share?
_No response_
### MDN metadata
Page report details
* Folder: `en-us/learn_web_development/extensions/server-side/django/development_environment`
* MDN URL: https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Server-side/Django/development_environment
* GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/learn_web_development/extensions/server-side/django/development_environment/index.md
* Last commit: https://github.com/mdn/content/commit/e82295d471ebda705947d0e5752421df3f85ad43
* Document last modified: 2026-08-07T01:19:07.000Z
Contributor guide
Assessment
This issue has not been assessed yet.