[Openstack-docs] Administration Guide-Design

Tom Fifield tom at openstack.org
Tue Jul 2 01:00:21 UTC 2013


On 02/07/13 10:59, Tom Fifield wrote:
> Welcome Summer! It's great to have you.
> 
> So, up until 30 seconds ago when I checked the wiki, I thought I had a
> good idea of our restructure, which is laid out as:
> https://wiki.openstack.org/wiki/Blueprint-restructure-documentation
> 
> On of the points of the restructure was to do away with the current
> administration guide (eg
> http://docs.openstack.org/trunk/openstack-compute/admin), because
> operators found it "exhaustive to the point of being past useless"[1].
> 
> The aim that I remember was to create a Configuration Reference, which
> would have much shorter introductions to each of the features in
> OpenStack, followed by a table of their configuration options
> automatically generated from code.
> 
> This was to be accompanied by a User guide, one for end-users of the
> cloud, and one for Administrators of the cloud (wich much shared content).

(there is also the existing Operations Guide, - for operations and
design best practices of course)

> 
> However, I now see that "Administration Guide" has been added to the
> wiki, which has caused me great confusion :)
> 
> 
> Regards,
> 
> 
> Tom
> 
> [1]https://bugs.launchpad.net/openstack-manuals/+bug/1110137
> 
> On 02/07/13 10:45, Nicholas Chase wrote:
>>
>> On 7/1/2013 8:06 PM, Summer Long wrote:
>>> Hi Anne,
>>> I've been working on OpenStack docs over at Red Hat, and would like to
>>> help with the OS Admin Guide.
>>> Can you tell me where I can contribute to its design? Steve Gordon tells
>>> me that the intent is to consolidate the various component guides?
>>
>> Hi, Summer --
>>
>> I've actually been pretty quiet here, but I'm currently working on a
>> plan for this consolidation -- blueprint to be up shortly, I promise! --
>> would you like to get together sometime this week to chat about how we
>> might work together on this?
>>
>>> I'm new to working with Open Source docs (previously worked with
>>> proprietary software houses), so am pretty excited about stepping over
>>> to the light side!
>>
>> I can't speak for anyone else, but for me, nice to have you here. :)
>>
>> ----  Nick
>>
>>> thanks,
>>> Summer
>>>
>>>
>>> Summer Long
>>> OpenStack Documentation
>>> Engineering Content Services
>>>
>>> Red Hat Asia Pacific
>>> Brisbane, Australia
>>> slong at redhat.com <mailto:slong at redhat.com>
>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> Openstack-docs mailing list
>>> Openstack-docs at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>>
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 




More information about the Openstack-docs mailing list