docs: add recommendation for ADR

openedx · Mar 1, 2023 · 0e1bd18 · 0e1bd18
1 parent 0b1f15b
commit 0e1bd18
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/oeps/best-practices/oep-0049-django-app-patterns.rst b/oeps/best-practices/oep-0049-django-app-patterns.rst
@@ -267,6 +267,11 @@ Do note that even if you expose your tasks through ``api.py`` to be used by othe
 still be configured with the ``tasks`` import name, as the celery identifier for your task (as set by the celery
 decorator) is based off the original file.
 
+docs/decisions/0001-purpose-of-this-repo.rst or 0001-purpose-of-this-app
+========================================================================
+
+This should be an architectural decision record (ADR) describing the decision behind adding the app. Future ADRs should also be placed in this directory.
+
 Consequences
 ************
 
@@ -279,6 +284,7 @@ Change History
 ==========
 
 * Changed type from "Architecture" to "Best Practice"
+* Added section for an ADR justifying the new app
 
 2021-04-23
 ==========