On 2017-11-16 11:45, Akihiro Motoki wrote: > 2017-11-16 19:33 GMT+09:00 Andreas Jaeger <[email protected]>: >> On 2017-11-16 11:27, Akihiro Motoki wrote: >>> 2017-11-16 18:59 GMT+09:00 Andreas Jaeger <[email protected]>: >>>> On 2017-11-15 19:07, Doug Hellmann wrote: >>>>> [...] >>>>> Someone needs to figure that out. Unfortunately, I don't have the >>>>> bandwidth right now. Maybe you, or someone else from one of the affected >>>>> projects, can work on it? >>>>> >>>>> Two options have been discussed so far: >>>>> >>>>> 1. Create special jobs for neutron and horizon projects that install >>>>> neutron or horizon, like we do for the release jobs. >>>>> >>>>> 2. Redefine the release notes job so that it doesn't use tox >>>>> but installs only the pieces it needs to run a sphinx build. The >>>>> CTI is already defined in a way to support that [1]. >>>>> >>>>> My current preference is for option 2. There may be other options >>>>> that we haven't explored, though. >>>> I gave it a try in https://review.openstack.org/520362. Note that this >>>> is only the building part, publishing part is separate - let's first >>>> iterate on this one, >>> I noticed most projects require to install themselves now to set >>> 'version' and 'release' variables in releasenotes/source/conf.py. >>> For example, >>> http://git.openstack.org/cgit/openstack/nova/tree/releasenotes/source/conf.py#n51 >>> I think we cannot build release notes without installing a project itself. >> >> That's really sad ;( >> >> But why would we need to set version and release for the releasenotes at >> all? We only have one - unversioned - document. >> >> I suggest to just get rid of it, > > Totally agree. > > I think when we migrated to openstckdocstheme version info was shown > in the rendered text > so we started to use version info in conf.py. Some projects started it > and most projects followed it. > After migrating openstckdocstheme there is no visible version info in > the rendered relnotes, > so I think we can drop it. > > Looking at the openstackdocstheme document [1], PDF generation > expects 'release' variable > but AFAIK we only generate HTML version of release notes and I think > we can drop 'release' > and 'version' variables from conf.py. > > [1] https://docs.openstack.org/openstackdocstheme/latest/
Testing now with: https://review.openstack.org/#/c/520373/ Andreas -- Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126 __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
