The dev environment used by some docs developers uses
an old version of tox, and does not support the
allowlist_externals entry required by tox 4.
The version of tox used by some other developers cannot
support tox.ini that contains both allowlist_externals and
whitelist_externals in the same file.
The fix for now is to stay with whitelist_externals and tox<4
This fix mostly reverts and re-works these two commits
https://review.opendev.org/c/starlingx/docs/+/869229https://review.opendev.org/c/starlingx/docs/+/868621
Partial-Bug: #2000399
Signed-off-by: Al Bailey <al.bailey@windriver.com>
Change-Id: Ib8a5eea5d27e7b7347bc717d11f9dc5a0be4f396
The docs repo publishes to the /, not the docs subdirectory. Use the new
promote job for this.
Depends-On: https://review.opendev.org/683059
Change-Id: I3c5ba425ce5c7646c9c2b9579ce332d3a725056f
Use templates instead of individual jobs so that these
can be changed in one place.
Depends-On: https://review.opendev.org/677606
Change-Id: I65ee3ccb1c2704b87384cc5a02ddd0664f797161
* Add pointers in the main doc to api-ref and releasenotes pages
* Add publish-stx-api-ref job
* Add search at bottom of api-ref and relnotes pages to trigger the jobs
* Add openstackdocstheme installation into requirements file
Change-Id: I11db7e584f3e16f1fd0517a5c0059bdc2d448399
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
We have the AFS volume and now a publish job, let's see if we
can get from here to there. Include a docs change to ensure
the jobs actually run.
the web server is near, pending certificate installation.
Change-Id: I325e97f0500e66b57b7d1cd2d2e81bee79c67f30
Signed-off-by: Dean Troyer <dtroyer@gmail.com>
* Use build-openstack-docs-pti for the main docs job rather than
the old legacy build-openstack-sphinx-docs-python3
* Use build-openstack-api-ref for the api-ref job (we can not
use OpenStack's api-ref-jobs template as it includes their
publisih jobs)
Change-Id: I646090e4dcc3260b3d963434a228bd5ef3a919fc
Signed-off-by: Dean Troyer <dtroyer@gmail.com>
Start with building Sphinx, include links to the anticipated locations
for /releasenotes and /specs.
Change-Id: I111e4dfc2a31a97b869df25e0d059b8423d25d6a
Signed-off-by: Dean Troyer <dtroyer@gmail.com>
[dtroyer: fixed linters job and added to gate queue so this can be merged]
Story: 2002813
Task: 22727
Change-Id: I8a988cc49440b21176dc95bd12ad383836148dca
Signed-off-by: Erich Cordoba <erich.cordoba.malibran@intel.com>