← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1871476] [NEW] Local docs build is broken

 

Public bug reported:

Steps to reproduce:

tox -e docs (add --recreate if needed)

Expected result: the build succeeds

Actual result: 2 errors (and possibly more):
1. Missing `hacking` module
2. After manually added `hacking` to `doc/requirements.txt` then repeated
   `tox --recreate -e docs`, the new error is
   "glance/doc/source/contributor/api/glance.hacking.rst is not added to the source tree"

For more details, see the attached logs.

However, this error doesn't occur on the gate, as in my following patches:
https://review.opendev.org/#/c/717889/
https://review.opendev.org/#/c/717873/

This bug has been reproduced and confirmed by abhishekk via our talk on
#openstack-glance IRC channel

Possible cause:

Based on the 2 errors details above, I highly suspect the cause comes
from this commit from Zuul routine:

Merge "Update hacking and reenable local checks" by Zuul
https://opendev.org/openstack/glance/commit/6d2c55bc769107207bd2a39059701b76ab27f2b0

** Affects: glance
     Importance: Undecided
     Assignee: Khuong Luu (organic-doge)
         Status: Confirmed


** Tags: documentation

** Changed in: glance
     Assignee: (unassigned) => Khuong Luu (organic-doge)

** Changed in: glance
       Status: New => Confirmed

** Description changed:

  Steps to reproduce:
  
  tox -e docs (add --recreate if needed)
  
  Expected result: the build succeeds
  
  Actual result: 2 errors (and possibly more):
  1. Missing `hacking` module
- 2. After manually added `hacking` to `doc/requirements.txt` then repeated 
-    `tox --recreate -e docs`, the new error is 
-    "glance/doc/source/contributor/api/glance.hacking.rst is not added to the source tree"
+ 2. After manually added `hacking` to `doc/requirements.txt` then repeated
+    `tox --recreate -e docs`, the new error is
+    "glance/doc/source/contributor/api/glance.hacking.rst is not added to the source tree"
  
  For more details, see the attached logs.
  
  However, this error doesn't occur on the gate, as in my following patches:
  https://review.opendev.org/#/c/717889/
  https://review.opendev.org/#/c/717873/
  
  This bug has been reproduced and confirmed by abhishekk via our talk on
  #openstack-glance IRC channel
  
  Possible cause:
  
  Based on the 2 errors details above, I highly suspect the cause comes
  from this commit from Zuul routine:
  
- Merge "Update hacking and reenable local checks"
+ Merge "Update hacking and reenable local checks" by Zuul
  https://opendev.org/openstack/glance/commit/6d2c55bc769107207bd2a39059701b76ab27f2b0

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Glance.
https://bugs.launchpad.net/bugs/1871476

Title:
  Local docs build is broken

Status in Glance:
  Confirmed

Bug description:
  Steps to reproduce:

  tox -e docs (add --recreate if needed)

  Expected result: the build succeeds

  Actual result: 2 errors (and possibly more):
  1. Missing `hacking` module
  2. After manually added `hacking` to `doc/requirements.txt` then repeated
     `tox --recreate -e docs`, the new error is
     "glance/doc/source/contributor/api/glance.hacking.rst is not added to the source tree"

  For more details, see the attached logs.

  However, this error doesn't occur on the gate, as in my following patches:
  https://review.opendev.org/#/c/717889/
  https://review.opendev.org/#/c/717873/

  This bug has been reproduced and confirmed by abhishekk via our talk
  on #openstack-glance IRC channel

  Possible cause:

  Based on the 2 errors details above, I highly suspect the cause comes
  from this commit from Zuul routine:

  Merge "Update hacking and reenable local checks" by Zuul
  https://opendev.org/openstack/glance/commit/6d2c55bc769107207bd2a39059701b76ab27f2b0

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


Follow ups