소스 검색

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>
Marcelo Galigniana 1 년 전
부모
커밋
2ddfa3e2b6
2개의 변경된 파일30개의 추가작업 그리고 0개의 파일을 삭제
  1. 29 0
      docs/howto/delete-app.txt
  2. 1 0
      docs/howto/index.txt

+ 29 - 0
docs/howto/delete-app.txt

@@ -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.

+ 1 - 0
docs/howto/index.txt

@@ -31,6 +31,7 @@ you quickly accomplish common tasks.
    static-files/deployment
    windows
    writing-migrations
+   delete-app
 
 .. seealso::