Fix building the Djblets 3 documentation.

Review Request #12141 — Created March 11, 2022 and submitted

Information

Djblets
release-3.x

Reviewers

There were a few breakages that prevented the Djblets documentation from
building.

  1. The djblets.settings module defined STATIC_URL to /, which
    conflicted with the effective default of MEDIA_URL. Now, both
    are set to explicit values.

  2. Some old deprecated modules were listed in the code reference
    documentation that have since been removed.

  3. Imports for .admin modules were failing, due to
    django.contrib.admin not being part of INSTALLED_APPS. This has
    been added, allowing us to import these modules.

There are still issues building some of the autodocs, but they don't break
the build. There are reference issues, bad directives/roles, and properties
we can't get method signatures from. These would need to be addressed
separately.

Successfully built the docs.

Summary ID
Fix building the Djblets 3 documentation.
There were a few breakages that prevented the Djblets documentation from building. 1. The `djblets.settings` module defined `STATIC_URL` to `/`, which conflicted with the effective default of `MEDIA_URL`. Now, both are set to explicit values. 2. Some old deprecated modules were listed in the code reference documentation that have since been removed. 3. Imports for `.admin` modules were failing, due to `django.contrib.admin` not being part of `INSTALLED_APPS`. This has been added, allowing us to import these modules.
9573e4cd0ec1ec58848112ce9882d152ce3f6d6a
david
  1. Ship It!
  2. 
      
chipx86
Review request changed

Status: Closed (submitted)

Change Summary:

Pushed to release-3.x (86c155f)
Loading...