← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1257725] [NEW] Building contributor documentation is broken

 

Public bug reported:

Following the steps listed at https://github.com/openstack/horizon
#building-contributor-documentation to build the contributor
documentation.

1) Building automatically, using ./run_tests.sh --docs fails with
ImportErrors and AttributeErrors (see attached file for details).

2) Building manually refers to non-existent file
generate_autodoc_index.py. Moreover, setting the env var
DJANGO_SETTINGS_MODULE has no effect as the scripts later override it
(it is hardcoded to openstack_dashboard.settings in both run_tests.sh
and doc/source/conf.py).

** Affects: horizon
     Importance: Undecided
         Status: New


** Tags: documentation

** Attachment added: "Failed attempt at building Horizon contributor documentation"
   https://bugs.launchpad.net/bugs/1257725/+attachment/3923091/+files/build_doc_fail.txt

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Dashboard (Horizon).
https://bugs.launchpad.net/bugs/1257725

Title:
  Building contributor documentation is broken

Status in OpenStack Dashboard (Horizon):
  New

Bug description:
  Following the steps listed at https://github.com/openstack/horizon
  #building-contributor-documentation to build the contributor
  documentation.

  1) Building automatically, using ./run_tests.sh --docs fails with
  ImportErrors and AttributeErrors (see attached file for details).

  2) Building manually refers to non-existent file
  generate_autodoc_index.py. Moreover, setting the env var
  DJANGO_SETTINGS_MODULE has no effect as the scripts later override it
  (it is hardcoded to openstack_dashboard.settings in both run_tests.sh
  and doc/source/conf.py).

To manage notifications about this bug go to:
https://bugs.launchpad.net/horizon/+bug/1257725/+subscriptions


Follow ups

References