<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Sep 4, 2013 at 2:42 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Diane, I like the idea - and propose to evaluate two more topics on top<br>
of it while we're doing major surgery.<br>
<br>
I don't know the history of how docs came together but diving into the<br>
project, I had two additional structure issues:<br>
<br>
First, why do we have doc/src/docbkx where doc and src have only a<br>
single directory? Can't we flatten this directly from doc/src/docbokx to<br>
doc?<br></blockquote><div><br></div><div>I'd like it flatter too, that is a maven convention for when you build items from more than one source place. So for the API reference for example, there's a src/docbkx and src/wadl convention. Still, I think we can safely flatten, we just have to have a known convention for where the pom.xml goes. Usually it goes into one folder up from src.</div>

<div><br></div><div>David Cramer, see any reason not to flatten to doc with the pom.xml with the xml source?</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<br>
Second, we have some guides that have a src subdirectory - and others<br>
have none. I propose to remove the current src subdirectories and move<br>
everything one level up. So, move openstack-user/src/* to openstack-user/<br>
<span class="HOEnZb"><font color="#888888"><br>
Andreas<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>