[Openstack-docs] Administration Guide-Design

Tom Fifield tom at openstack.org
Tue Jul 2 00:59:23 UTC 2013


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).

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




More information about the Openstack-docs mailing list