Open Stack

On 2019-03-28 11:21:28 +0000 (+0000), Sean Mooney wrote:
[...]
> im not really opposed to the ideas put forward here but can we
> kill the nova-specs repo and just move it to an in tree specs
> folder in the nova repo.
[...]

A few things you may want to consider with this plan:

1. You release and branch nova but not nova-specs, so moving your
specs into nova means they will also now be released and branched as
a part of nova. When specs change on master, will you backport those
changes to the stable branch versions? Note that documentation is
published independently for each branch so you'll potentially have
different versions of the same spec published with documentation for
each branch.

2. The Nova team has other deliverable repos besides nova itself, so
if a spec is more relevant to another deliverable would it still
reside in the nova repo, or elsewhere?

3. Keeping specs with the rest of your in-repository documentation
makes it harder to use different Sphinx themes or configuration for
specs as opposed to other docs.

4. Most (all?) OpenStack specs repos currently publish to
specs.openstack.org rather than docs.openstack.org so this may make
Nova's harder to find (or may make them easier to find if most
people were expecting them to be in Nova's documentation, I can't
really say what random readers expect if anything).
-- 
Jeremy Stanley
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 963 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20190328/26e6e4cb/attachment.sig>