Open Stack

Andreas, 

I agree with getting rid of the parent directories: doc/src/docbkx.

As for the src directory inside a book directory, I think we need those -
to me the structure should be:


book-folder
	pom.xml
	src
		figures
		wadls
		examples
		(whatever)
	target
		ŠŠ


To me, this is a cleaner structure and easier to navigate.


Diane
----------------------------------------------
Diane Fleming
Software Developer II - US

diane.fleming at rackspace.com
Cell  512.323.6799
Office 512.874.1260
Skype drfleming0227
Google-plus diane.fleming at gmail.com






On 9/4/13 2:52 AM, "Andreas Jaeger" <aj at suse.com> wrote:

>On 09/04/2013 09:42 AM, Andreas Jaeger wrote:
>> Diane, I like the idea - and propose to evaluate two more topics on top
>> of it while we're doing major surgery.
>> 
>> I don't know the history of how docs came together but diving into the
>> project, I had two additional structure issues:
>> 
>> First, why do we have doc/src/docbkx where doc and src have only a
>> single directory? Can't we flatten this directly from doc/src/docbokx to
>> doc?
>> 
>> Second, we have some guides that have a src subdirectory - and others
>> have none. I propose to remove the current src subdirectories and move
>> everything one level up. So, move openstack-user/src/* to
>>openstack-user/
>
>I also volunteer to help with the overall transition doing a book or two,
>
>Andreas
>-- 
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126