[Openstack-docs] Review: Program description for OpenStack Documentation

Anne Gentle annegentle at justwriteclick.com
Wed Jul 24 15:35:11 UTC 2013


On Wed, Jul 24, 2013 at 8:38 AM, Diane Fleming <diane.fleming at rackspace.com>
wrote:
>
> A few suggestions – take them or leave them!
>
> First sentence – lead with the documentation part. The word "adoption" is
unnecessary (I think).
> Second sentence – what's the difference between "develop" and "create"? X
the word create.
> I think the "treated like OpenStack code" part needs its own sentence
because I don't understand what it means in the context of the second
sentence.
>
>
> Provide documentation for core OpenStack projects to promote OpenStack.
> Develop and maintain tools and processes to ensure quality, accurate
documentation.
> Treat documentation like OpenStack code.


I like this -- For the detailed mission statement I'll describe that we
treat documentation like OpenStack code by patching, reviewing, tracking
bugs, and providing release documentation.

I'll send the statement, thanks all for the input!
Anne

>
>
> Diane
> ----------------------------------------------
> Diane Fleming
> Software Developer II - US
> diane.fleming at rackspace.com
> Cell  512.323.6799
> Office 512.874.1260
> Skype drfleming0227
> Google-plus diane.fleming at gmail.com
>
> From: Anne Gentle <annegentle at justwriteclick.com>
> Date: Monday, July 22, 2013 3:20 PM
> To: Nicholas Chase <nchase at mirantis.com>
> Cc: "openstack-docs at lists.openstack.org" <
openstack-docs at lists.openstack.org>
>
> Subject: Re: [Openstack-docs] Review: Program description for OpenStack
Documentation
>
> You know, I'm thinking it's overly complex and "listy" anyway. I think
this is simpler, and I meant to indicate core:
>
> Promote OpenStack adoption by providing documentation for core projects.
Develop, maintain, and create tools and processes to ensure quality,
accurate documentation treated like OpenStack code.
>
> Thoughts on simplifying?
>
>
> On Mon, Jul 22, 2013 at 1:51 PM, Nicholas Chase <nchase at mirantis.com>
wrote:
>>
>>
>>
>> On 7/22/2013 1:09 PM, Anne Gentle wrote:
>>>
>>> Mission Statement:
>>> Promote OpenStack adoption by providing documentation for installing,
>>> configuring, administrating, and using OpenStack clouds. Develop,
>>
>>
>> OK, this is nitpicky, but is it "administrating" or "administering"?  I
mean, I know we SAY administrating, but I've always considered it a "fun"
word, like "automagically".
>>
>> ----  Nick
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
>
>
> --
> Anne Gentle
> annegentle at justwriteclick.com




--
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130724/35828373/attachment.html>


More information about the Openstack-docs mailing list