-
Notifications
You must be signed in to change notification settings - Fork 32
Open
Description
If you use cookiecutter-django-ida and complete all of the setup steps, then run make requirements docs, the docs build fails. There are a number of things that need to be fixed before it succeeds.
Acceptance criteria:
-
make docsis added to the tests for cookiecutter-django-ida. Currently this would need to be added as a new step in theci.ymlGitHub workflow under therun_ida_testsjob, but it's possible that these tests will have been moved to the actual Python unit tests by the time this ticket has been picked up. The test should runmake doc_requirements docsor similar.
Known issues that will need fixing:
cookiecutter-django-ida/hooks/post_gen_project.pyneeds to includeextra_context["requires_django"] = "yes"just like the django-app cookiecutter does, otherwise there will be a failure when autodoc importsurls.py- The template will need to be expanded to allow layered cookiecutters to specify what the Django settings module is; django-app uses
test_settingsand that is hardcoded into python-template'sdocs/conf.py, but django-ida will need to use{{ repo_name }}.settings.testor similar. - There's some kind of issue with a logo reference (have lost the details, but just mentioning this because it will come up)
Metadata
Metadata
Assignees
Labels
No labels