mirror of https://github.com/django/django.git
[4.2.x] Fixed #34309 -- Doc'd how to fully delete an app.
Co-authored-by: nessita <124304+nessita@users.noreply.github.com>
Co-authored-by: shangxiao <shang.xiao.sanders@gmail.com>
Co-authored-by: sarahboyce <42296566+sarahboyce@users.noreply.github.com>
Co-authored-by: felixxm <felisiak.mariusz@gmail.com>
Backport of 2ddfa3e2b6
from main
This commit is contained in:
parent
e54f711d42
commit
f474ba4cb5
|
@ -0,0 +1,29 @@
|
|||
==================================
|
||||
How to delete a Django application
|
||||
==================================
|
||||
|
||||
Django provides the ability to group sets of features into Python packages
|
||||
called :doc:`applications</ref/applications/>`. When requirements change, apps
|
||||
may become obsolete or unnecessary. The following steps will help you delete an
|
||||
application safely.
|
||||
|
||||
#. Remove all references to the app (imports, foreign keys etc.).
|
||||
|
||||
#. Remove all models from the corresponding ``models.py`` file.
|
||||
|
||||
#. Create relevant migrations by running :djadmin:`makemigrations`. This step
|
||||
generates a migration that deletes tables for the removed models, and any
|
||||
other required migration for updating relationships connected to those
|
||||
models.
|
||||
|
||||
#. :ref:`Squash <migration-squashing>` out references to the app in other apps'
|
||||
migrations.
|
||||
|
||||
#. Apply migrations locally, runs tests, and verify the correctness of your
|
||||
project.
|
||||
|
||||
#. Deploy/release your updated Django project.
|
||||
|
||||
#. Remove the app from :setting:`INSTALLED_APPS`.
|
||||
|
||||
#. Finally, remove the app's directory.
|
|
@ -31,6 +31,7 @@ you quickly accomplish common tasks.
|
|||
static-files/deployment
|
||||
windows
|
||||
writing-migrations
|
||||
delete-app
|
||||
|
||||
.. seealso::
|
||||
|
||||
|
|
Loading…
Reference in New Issue