Commit Graph

8 Commits

Author SHA1 Message Date
Al Bailey 5c86db74c8 Pin tox to be less than 4
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/+/869229
https://review.opendev.org/c/starlingx/docs/+/868621

Partial-Bug: #2000399

Signed-off-by: Al Bailey <al.bailey@windriver.com>
Change-Id: Ib8a5eea5d27e7b7347bc717d11f9dc5a0be4f396
2023-01-13 14:00:16 +00:00
Andreas Jaeger 43f388cd5a Update publishing
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
2019-09-19 10:46:27 +02:00
Andreas Jaeger 24cb0613d8 Use Zuul templates
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
2019-08-21 12:58:12 +00:00
Dean Troyer f253a48c45 Add api-ref publish job
* 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>
2018-10-12 18:32:17 +00:00
Dean Troyer b003280698 Add the publish job
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>
2018-10-02 16:29:20 -05:00
Dean Troyer 97252e1fc8 Use correct docs jobs
* 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>
2018-09-27 16:18:24 -05:00
Dean Troyer 51c2529fe2 Add docs build jobs
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>
2018-09-04 09:58:56 -05:00
Erich Cordoba 812c86bacd Create initial template for documentation
[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>
2018-07-23 11:10:41 -05:00