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

Lana Brindley openstack at lanabrindley.com
Wed Nov 6 01:08:45 UTC 2013


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.

Lana

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



More information about the Openstack-docs mailing list