Open Stack

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.

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<mailto:annegentle at justwriteclick.com>>
Date: Monday, July 22, 2013 3:20 PM
To: Nicholas Chase <nchase at mirantis.com<mailto:nchase at mirantis.com>>
Cc: "openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>" <openstack-docs at lists.openstack.org<mailto: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<mailto: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<mailto:Openstack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs



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