diff --git a/docs/architecture/decisions/0021-django-admin.md b/docs/architecture/decisions/0021-django-admin.md index 6e9580932..bca51c2ef 100644 --- a/docs/architecture/decisions/0021-django-admin.md +++ b/docs/architecture/decisions/0021-django-admin.md @@ -34,6 +34,13 @@ In contrast to building an admin interface from scratch where development activi involve _building up_, leveraging Django Admin will require carefully _pairing back_ the functionalities available to users such as analysts. +On accessibility: Django admin is almost fully accessible out-of-the-box, the expections being tables, checkboxes, and +color contrast. We have remedied the first 2 with template overrides and the 3rd with theming (see below). + +On USWDS and theming: Django admin brings its own high level design framework. We have determined that theming on top of Django (scss) +is easy and worthwhile, while overwriting Django's templates with USWDS is hard and provides little return on investment +([research PR](https://github.com/cisagov/getgov/pull/831)). + While we anticipate that Django Admin will meet (or even exceed) the user needs that we are aware of today, it is still an open question whether Django Admin will be the long-term administrator tool of choice. A pivot away from Django Admin in the future would of course mean starting from scratch at a later date, and potentially juggling two separate admin