43 Commits

Author SHA1 Message Date
Doug Hellmann
b3d408541a make sphinxext support eol tags
Fix the sorting for EOL tags so when we collapse the release history
of a project to show it on the web site the sort works.

Also skip over the EOL tags when determining the "latest" release from
the branch. They are still displayed as part of the full tag history.

Change-Id: Iedde30f65bdfa89db0c6697ff031a75350090892
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-06-15 09:37:30 -04:00
Doug Hellmann
a817e3a6ab show per-deliverable stable status on releases.o.o
Add an API to Deliverable to let the sphinxext inject the series status
information, since the build conditions and working directory are
different under sphinx.

Change-Id: Id2bbdc4815564d28a5f4989bf7c74aed93e8c129
Story: #2001852
Task: #12620
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-04-20 15:58:57 -04:00
Doug Hellmann
c0dbd2bc88 change the section title for cycle-trailing projects
We still want to eventually change the release model name, but that's
going to be a little more complicated. In the mean time, change the
section title to reflect the fact that we expect only packaging and
deployment tools to use the cycle-trailing release model.

Change-Id: Ie7fcc06cbc9453c69caaef4bdd38edb3857f35c1
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-03-09 16:33:19 -05:00
Doug Hellmann
1b736e3f32 update sphinxext to use deliverable model classes
Change-Id: I38c8147677b37df2b6e0e995455dbd96099a3eb4
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-03-07 10:49:50 -05:00
Doug Hellmann
e0c0a0d823 use case-insensitive sort for teams on highlights page
Change-Id: If6b603b6d94f5ac7dceb5149bb8ac2e238e810a8
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-02-08 18:36:43 -05:00
Sean McGinnis
7c393831f2 Sort team names in highlight output
Teams were being added in the order they were processed, which
could result in a jumbled list in the generated highlights page.

This sorts the teams by name to have some logical ordering to
the results to make it easier to locate specific team notes in
the output.

Change-Id: I91fef6e5e5aed71f285ba96d5458ad56568d1335
2018-02-07 10:54:57 +00:00
Sean McGinnis
da97a955c9 Switch cycle higlights to string list
The original thought was to have this contain rich formatting
like used in reno. But the reality is, for what this is used
for, we really just want a bulleted list of highlights for
each project.

Based on the first couple of patches, this has been a point of
confusion for those trying to use this directive. This patch
simplifies things by just treating the cycle-highlights as a
list that gets added as bullet items to the generated results.

Change-Id: If265606eb20fa3d49e3cf4a684ea683de4267927
2018-02-02 19:16:10 -05:00
Doug Hellmann
5d7d357c8f add client-library deliverable type
Change-Id: I71cc5f979b20ac9218520c75d85237ea81867581
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-01-29 19:32:51 -05:00
Sean McGinnis
3cf1056d72 Add useful info to cycle highlights
In order to help consumers of the cycle highlights data, this pulls in
some additional information about each team to have more of that info
in one easy to consume place.

Change-Id: Id45345999df5e204a8fa613676b3f27442551da7
2017-12-09 13:22:33 -06:00
Doug Hellmann
da85f18fa2 fix default initial setting for accumulating notes
Start with an empty string instead of None to avoid having all output
prefixed with "None".

Include additional debugging info, with some commented out for local
use later.

Change-Id: Ie09d740ad6bf0f396a26631e2db82801c043d248
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-11-16 13:29:13 -05:00
Sean McGinnis
8adf5e0b94 Add release highlights
This adds the ability to provide release highlights in the deliverable
yaml file. These highlights can then be extracted and displayed into
published documentation using a new 'cycle-highlights' directive.

Change-Id: I40791dad4b5a4d2c4089e5e43d52f00b52cc3217
2017-10-25 18:41:08 +00:00
Doug Hellmann
011c65b55a default deliverable type to other in sort
The validation job now requires type to be set, but we have several old
deliverables without it. Rather than edit all of them, set the default
to 'other' to avoid comparing None with a string.

Change-Id: I4e5a1d5f19dac8f6253bc7d6d040e1869c004d08
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2017-03-03 15:43:25 -05:00
Doug Hellmann
4305adb190 teach missing-releases to look for artifacts as well as tags
We need a tool to verify that the release artifacts exist on the
tarballs site. The missing-releases command was already looking for
missing tags, so have it look for the tarballs, too.

This change refactors the URL generation code into a separate module so
it can be used by missing-releases and the sphinx extension. It also
creates a reusable function for testing a link, and has the gitutils
module functions responsible for looking for tags, branches, etc. use
it.

Change the default behavior to only look at the most recent release for
each deliverable, and add an option to go back to the previous behavior
of scanning all of them.

Change-Id: Ic7345466ccd83cf2d8d9d6d019107d6fbba171cc
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-12-16 16:05:58 -05:00
Davanum Srinivas
6c57dda8f6 Add links to the package signatures
Since (and including) Ocata, Infra has been maintaining
a signing system for artifacts and publishing the
signatures:
http://docs.openstack.org/infra/system-config/signing.html

We should publish these signatures as part of the release
web site.

Change-Id: I06c099cdf9a2068f5d41f41f51176167374b577b
2016-12-13 10:13:37 -05:00
Doug Hellmann
d775c650e7 allow deliverable files without any releases
When we initialize a new series, we will have deliverable files without
any releases, yet. Ensure the validation, list-changes, and sphinx
extension code works in that case.

Change-Id: I724c2f77dac8c38e7145c00fc37a27d2078f9e69
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-12-05 11:04:04 -05:00
Doug Hellmann
81b1bbaf62 use local type and model data for releases.openstack.org
Update the sphinx extension to pull the release model and project type
from the local deliverable file instead of the governance repository.

Change-Id: Iddc1accc52fdcc6f0fad9993ec073de325f3a4b0
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-11-09 17:09:03 -05:00
Doug Hellmann
1d09ac0a22 use the new type:horizon-plugin tag
Show horizon plugins in their own section of series pages.

Change-Id: I145892f5e2e38fdac5f0fee40edbf0f037ff7a8e
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-06-21 16:35:47 -04:00
Doug Hellmann
9d12f20416 maintain team ownership info in the deliverable files
Teams add and remove repositories, change owners of repositories, and
are themselves removed over time. We can't rely on the current version
of the governance repository to include the information about who owned
a deliverable, so we need to put that information here in the releases
repository where we can track changes over time.

This patch adds support for a required "team" field to the deliverable
file, using the values set in previous patches in the series, and
updates the rendering code to use it instead of the project list from
the governance repository.

Signed-off-by: Doug Hellmann <doug@doughellmann.com>
Change-Id: I5941072c641c05bf0983984cae29a34927246d86
2016-06-09 14:34:21 -04:00
Doug Hellmann
826430761f fix sorting and pre-release collapsing
An earlier patch added sorting so we could support mixing releases
for independent projects. The sort change broke the pre-release
collapsing logic, so we were showing release candidates as newer than
final releases. This change fixes the sorting logic to ensure that
pre-releases come before finals by ensuring that we can always parse
the version string.

Change-Id: I3aa2e84c90ea05abe933bad0f32e902f39797b84
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-25 17:45:58 -04:00
Jenkins
a46dd9651d Merge "sort version numbers as we display them" 2016-05-23 15:05:15 +00:00
Jenkins
59f8e32102 Merge "clean up independent project listsinggs" 2016-05-23 15:05:09 +00:00
Doug Hellmann
d320a12ab0 show release:cycle-trailing projects separately
Group the projects that trail the release cycle separately from the
other projects, rather than including them in the proper "type"
sections.

Change-Id: I97c209151a91ff5a18683c883ebca41c5386ff5c
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-18 16:38:33 -04:00
Doug Hellmann
5dd5162e85 sort version numbers as we display them
We have been relying on folks adding entries to the deliverable files in
release order. That breaks the scripts that actually prepare the
releases, since those scripts only look at the last entry in each file
and releasing a stable version of an independent project often means
inserting an entry into the middle of the deliverable file.

This change tries to sort the versions in the deliverable files as it
reads them before building any tables. We use a tuple of the parts of
the version string, converted to integers where possible to avoid weird
alphabetical sorting of numbers and because SemanticVersion can't always
parse some of the legacy version tags project teams used.

The patch includes one change to an existing deliverable file to
demonstrate that the output is sorted properly.

Change-Id: I962a38db6ca79be02a3fdc8d387e30ee86a6a61c
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-18 16:03:03 -04:00
Doug Hellmann
55c52622a8 clean up independent project listsinggs
Turn "_Independent" to "Independent" on the team pages.

Move the independent section on the main page above the team list to
make it easier to find.

Change-Id: I670643a791c7618a5c1febb7ec63e9540d4f206d
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-18 15:20:17 -04:00
Doug Hellmann
a65d9f5c3d add team pages
Add pages to show the work each team has produced. For now, only
official teams using cycle-based release models are included. In a later
phase we will add deliverables that are currently listed as indepdent.

Change-Id: Ieb54aa7a4d2f58f462692e295c8f19978d5baa73
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-13 10:57:44 -04:00
Doug Hellmann
447027caf6 support multiple release notes links
Add support for multiple release notes links for deliverables composed
from multiple libraries.

Change-Id: I2f02028da456c96813eecbdbbb21307088c64476
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-05-11 11:14:01 -04:00
Doug Hellmann
bf2443d340 add artifact-link-mode option
The openstack-ansible project doesn't produce separate tarball
artifacts, so give them a way to turn off links that point to files that
don't exist.

Change-Id: I3fa5a053b61cd57e65222cde785ea7742870c8ee
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-03-11 13:47:24 -05:00
Doug Hellmann
cdd514b9f4 collapse pre-releases into final releases
When a final release is prepared, stop showing any preceding
pre-releases for that same version.

Change-Id: I0a73c72de1af5796f90deaaabbc2dbaba7abee32
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-02-26 13:51:06 -05:00
Doug Hellmann
2932c2b000 support tarball names that do not match the repository name
Change-Id: I1bde36fe8272edb0d5b3bf89875395dccc2a8557
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2016-02-26 13:16:54 -05:00
Jenkins
37341bd7c6 Merge "add release notes links" 2015-12-02 15:06:49 +00:00
Doug Hellmann
c6485818c8 add release notes links
For old releases, link to the wiki pages.

For liberty, link to the wiki and add links to the reno-generated
release notes pages that are available.

Change-Id: Iac5dbf2a64257d7457b136483322b2cb0d65fd1e
2015-11-30 21:50:28 +00:00
Doug Hellmann
5b94ca9888 use HTTPS for tarball links
The tarball server now supports HTTPS, so default to using it for all
generated links.

Change-Id: I2313cff088a3127ccc260dd82e24e9913b456aa6
2015-11-25 14:17:05 +00:00
Doug Hellmann
76c93bbca9 display release:independent projects on a separate page
Show all of the release:independent projects release histories on a
separate page, now that they have moved out of the release series
directories.

Change-Id: I3fddbca590b1a8fcacc180a2730f0463dbcc0100
2015-11-11 22:06:25 +00:00
Thierry Carrez
46feb821ba Add section for deliverables with no type
Deliverables which do not have any type were assumed to be
type:service deliverables and were listed with services,
resulting in a crowded and confusing output.

This patch makes sure they are listed in their own section.
It is still wrong for some of them (which should really have the
type:service tag), but less wrong than considering them all as
services.

Change-Id: I828b0fb245443cf5e3fb50c222da3f70c65a014b
2015-11-05 14:51:54 +01:00
Doug Hellmann
3f8d6b24ef provide download links
Turn the version numbers in the tables into download links for
the tarball of a project at that version.

Change-Id: Id3fb9fbec75bc6b099589fd09a4cd4fafbc709e7
2015-10-07 17:42:38 +00:00
Doug Hellmann
67b2d7ccda remove unused rubric function
Change-Id: I804e4d9968fa33c1fde1a9bf2502b3b56ee5ccee
2015-10-06 21:17:56 +00:00
Doug Hellmann
7cf0eedaf7 show more of the release summary in table
Include the earliest release and the most recent release in the summary
table at the top of each deliverable-type section.

Change-Id: Ib0704f4639bc6e350a9587aefba2819b65128940
2015-09-01 21:37:38 +00:00
Doug Hellmann
15b0758543 group service and library projects separately
Split the deliverables based on whether they are a service or
library. Default to service, since we do have some untagged projects and
they tend toward service rather than library.

Change-Id: Icaa2bacf5aadf7c53543c6c4a1abc5ef62eb77e7
2015-09-01 21:37:33 +00:00
Doug Hellmann
85702075de tighten up the tables within each deliverable section
Change-Id: I4ef0dfda44a65943ef27836a3d7708e8dcb45540
2015-08-21 18:51:32 +00:00
Doug Hellmann
7670133195 clean up 'most recent' table
Change-Id: I7b2a4bbb113c20a44a0b305fdbdc004c2bd0a7b5
2015-08-21 18:50:38 +00:00
Doug Hellmann
86e11432d4 show version history from most new to old
Change-Id: I730f5fa5a1e3a976fa9c2e741bcd37de913bf757
2015-08-21 18:50:25 +00:00
Doug Hellmann
3fefe6073e add 'most recent' table to each page
Change-Id: I03ff22e7f86c931343f176727b6f8a5fc67b331f
2015-08-21 18:50:23 +00:00
Doug Hellmann
a6504c20f9 add deliverables directive and source files
Change-Id: I8da828e08286f371d7c2802810ad25f7eb2365a4
2015-08-21 18:00:18 +00:00