[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