[Openstack-docs] What's Up Doc? Special Summit Edition Nov 5 2013

Andreas Jaeger aj at suse.com
Thu Nov 7 19:12:36 UTC 2013


On 11/06/2013 02:08 AM, Lana Brindley wrote:
> On 06/11/13 09:31, Nicholas Chase wrote:
>>
>>
>> On 11/5/2013 6:26 PM, Anne Gentle wrote:
>>>
>>>
>>>
>>> On Tue, Nov 5, 2013 at 12:37 PM, Nicholas Chase <nchase at mirantis.com
>>> <mailto:nchase at mirantis.com>> wrote:
>>>
>>>     Yeah, I think Nermina's right here; both admins and installers need
>>>     the config reference, I would think -- correct me if I'm wrong -- so
>>>     at the very least the parameters need to be extracted into one place
>>>     to be shared by both roles.
>>>
>>>     Which actually begs the question, do we want to remove all the "how
>>>     to configure" information and put it in the admin guide, since we'll
>>>     then also have to repeat it in the install guide?
>>>
>>>
>>> The install guide should only have a handful of adventures, not all the
>>> networking and storage use cases. Think happy path for install guide. :)
>>
>> So an easy, quick install in the install guide, and then you go
>> elsewhere to find out how to do something more complicated?  I'm in.
>>
>> And then you go to the Admin guide for that more complicated use case?
>> That works for me.
> 
> I am absolutely in favour of this.

I'm fine as well.

I do like to see this documented in the wiki - explain on a single page
the goal of each book and how they relate to each other.

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



More information about the Openstack-docs mailing list