openstack team mailing list archive
-
openstack team
-
Mailing list archive
-
Message #00058
Re: Please welcome our new Technical Writer Anne Gentle
Hello Anne,
Speaking as someone who is interested in using OpenStack but is not involved in the project directly, I'd love to see some "getting up and running" documentation, since that's the first hurdle a potential user (like me) needs to overcome.
As an example of well-written "getting started" documentation, I find the "Writing your first Django app" tutorial to be very useful: http://docs.djangoproject.com/en/dev/intro/tutorial01/
Lorin
--
Lorin Hochstein, Computer Scientist
USC Information Sciences Institute
703.812.3710
http://www.east.isi.edu/~lorin
On Sep 10, 2010, at 2:58 PM, Anne Gentle wrote:
> Thanks all! I'm going to ask lots of questions I'm sure, but for starters I'd love to get your thoughts either on this list, on IRC, or as comments on the blog post about:
>
> - What are examples of your favorite technical documentation (sites or books or...)? What attributes make it your favorite?
>
> - What do you think should be the goals of OpenStack technical documentation? Support? Adoption? Education? All of the above?
>
> - Who do you see as the main consumers of this technical documentation - developers, administrators, dev-ops, web-ops, is there another group we need to address?
>
> I got my wiki geek on today by doing an inclusion in MoinMoin so I'm looking forward to building reusable modular pages in the wiki. :) Plus I'll have a development environment set up in the next few weeks so I can add to the developer documentation.
>
> Looking forward to serving the community.
>
> Thanks,
> Anne
>
>
> On Fri, Sep 10, 2010 at 11:24 AM, Jay Pipes <jaypipes@xxxxxxxxx> wrote:
> Welcome, Ann! Great to have you on board! :)
>
> -jay
>
> On Thu, Sep 9, 2010 at 6:39 PM, Rick Clark <rick@xxxxxxxxxxxxx> wrote:
> > OpenStack community,
> > I am very happy to welcome Anne Gentle,who started Tuesday, to the
> > OpenStack community. Anne has a great background both in tech writing
> > and open source. She can introduce herself better than I can.
> >
> > http://openstack.org/blog/2010/09/content-stacker-reporting-for-duty/
> >
> > You can read her personal blog and see a picture of her smiling face
> > here: http://justwriteclick.com/
> >
> > I am sure you will all be hearing from her as she tries to whip our
> > release documentation into shape and helps build our community. I am
> > VERY excited to have her with us.
> >
> >
> > Rick Clark
> > OpenStack Chief Architect
> >
> >
> > _______________________________________________
> > Mailing list: https://launchpad.net/~openstack
> > Post to : openstack@xxxxxxxxxxxxxxxxxxx
> > Unsubscribe : https://launchpad.net/~openstack
> > More help : https://help.launchpad.net/ListHelp
> >
> >
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to : openstack@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack
> More help : https://help.launchpad.net/ListHelp
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to : openstack@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack
> More help : https://help.launchpad.net/ListHelp
Attachment:
smime.p7s
Description: S/MIME cryptographic signature
References