mdn / mdn/content

Django Dev Environment Setup Inaccurate

Open
#45,255 6 comments 0 reactions 1 assignee Claimed by @hamishwillee View on GitHub
Content:Learn:Django
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.