<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jul 17, 2015 at 3:02 AM, Thierry Carrez <span dir="ltr"><<a href="mailto:thierry@openstack.org" target="_blank">thierry@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">Doug Hellmann wrote:<br>
> Excerpts from Anne Gentle's message of 2015-07-16 08:14:54 -0500:<br>
>> On Thu, Jul 16, 2015 at 6:58 AM, Doug Hellmann <<a href="mailto:doug@doughellmann.com">doug@doughellmann.com</a>><br>
>> wrote:<br>
>><br>
>>> Excerpts from Andreas Jaeger's message of 2015-07-16 08:11:48 +0200:<br>
>>>> Doug,<br>
>>>><br>
>>>> I'm missing openstackdocstheme and openstack-doc-tools in your import.<br>
>>>> How do you want to handle these?<br>
>>><br>
</span><span class="">> One sticking point with these tools is that they don't fit into our<br>
> current definition of a deliverable, which is "N repos that share a<br>
> launchpad project and version number."<br>
<br>
</span>My non-technical definition for a deliverable (or "a thing we release")<br>
is a produce of the project team that is intended to be used by others,<br>
and therefore new releases need to be published and communicated.<br>
<br>
Since it is meant to be used by others, those should also have a<br>
Launchpad project so that users can report issues with it.<br>
<br>
So the question here is more: are openstackdocstheme and<br>
openstack-doc-tools products of the Documentation project team that are<br>
intended to be used outside of that team.<br>
<br>
If the answer is "yes" then they should have a Launchpad project and be<br>
considered a deliverable. If the answer is "no" then while they may have<br>
tags, they don't really need releases or direct user feedback, so the<br>
Launchpad project may be overkill.<br>
<br>
openstack-doc-tools seems to lean in the "yes" direction, I could find<br>
it used by a couple projects in test-requirements.<br>
<br>
openstackdocstheme seems to be used only in infra, so I guess it could<br>
go either way. I'm not really sure what releases/tags achieve there...<br>
<span class=""><br>
> 1. Create separate launchpad projects for each of them, so they can be<br>
> managed independently like the other projects.<br>
><br></span></blockquote><div><br></div><div>Okay, we currently track both of these with the openstack-manuals project in Launchpad but it's fine to create separate Launchpad projects for each. </div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
> 2. Start releasing and versioning them together.<br></span></blockquote><div><br></div><div>No reason for this really that I can think of.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
><br>
> 3. Add support for a deliverable type with no launchpad project, which<br>
> would skip the launchpad updates.<br></span></blockquote><div><br></div><div>Would a single Launchpad project work for both, or not? </div><div><br></div><div>Thanks,</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
><br>
> I like option 1, with 3 being a fallback. I don't really see option 2 as<br>
> viable.<br>
><br>
> What does everyone else think?<br>
<br>
</span>Following my train of thoughts from the "deliverable" definition above,<br>
option 1 is the only that makes sense (with option 2 as a backup, but<br>
that would not be a good fit in this particular case).<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Thierry Carrez (ttx)<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>