← Back to team overview

openstack-doc-core team mailing list archive

Re: Tracking third-party OpenStack documentation and docs.openstack.org

 

I like the blog idea - Stefano is talking about switching the planet blog
to a new Wordpress system anyway. This concept of writing articles is what
I discussed a bit at the Design Summit. I think we still need a way to make
posts part of the official documentation. For example, I just pulled in a
"customizing the dashboard" section from a blog entry, re-writing slightly.
That should go forward with the docs because it's something everyone needs
to know. But there's plenty of other docs that should live as blog entries.
CCing Stefano to see if he knows the state of the Wordpress tooling around
the blog aggregator.

I like the idea of a fourth self-identifier on the home page- "New to
OpenStack" - does anyone have time to mock it up using the index.html we
have?

Anne

Anne Gentle | http://justwriteclick.com/

[image: Facebook] <http://facebook.com/conversationandcommunity>[image:
Linkedin] <http://linkedin.com/annegentle>[image:
Twitter]<http://twitter.com/annegentle>


On Fri, May 11, 2012 at 8:23 PM, Lorin Hochstein
<lorin@xxxxxxxxxxxxxxxxxx>wrote:

> Doc folks:
>
> It seems like there's a lot of third-party OpenStack documentation being
> generated, both in the form of manuals (like below), and random how-to blog
> posts, and I have a hard time keeping track of it all. Do we have a
> mechanism for tracking pointers to external docs?
>
> If not, could we set up a blog dedicated to OpenStack documentation? It
> would basically just contain links to docs as we encounter them. The blog
> format is nice since it's chronological, so newer stuff is prioritized.
> Even a twitter feed could be useful.
>
> We do have the main blog, and Stefano's newsletter, and both of those have
> doc references, but I was thinking about a feed that was only about docs.
>
> ---
>
> Also, I was looking at docs.openstack.org, and thinking it might be a
> little confusing for newbies. It might be helpful to have language like:
>
> * New to OpenStack and want to get up and running with it as soon as
> possible? Look at the Starter Guide
> * Planning a new production deployment of OpenStack? Look at the Install
> and Deploy Guide
> * Looking for a detailed reference? Look at the Administration Guide.
>
> Or maybe
>
>
>
>
>  Take care,
>
> Lorin
> --
> Lorin Hochstein
> Lead Architect - Cloud Services
> Nimbis Services, Inc.
> www.nimbisservices.com
>
>
>
>
>
> Begin forwarded message:
>
> *From: *Atul Jha <Atul.Jha@xxxxxxxxxxx>
> *Subject: **[Openstack] Openstack Beginners guide for Ubuntu 12.04/Essex*
> *Date: *May 10, 2012 10:33:22 AM EDT
> *To: *"openstack@xxxxxxxxxxxxxxxxxxx" <openstack@xxxxxxxxxxxxxxxxxxx>
>
> Hi all,
>
> We at Csscorp have been publishing series of beginners guide on
> Ubuntu/Openstack (versions), in continuation with that we have released
>  the latest version of our book with Essex and Ubuntu 12.04.
>
>
> http://cssoss.wordpress.com/2012/05/07/openstack-beginners-guide-v3-0-for-essex-on-ubuntu-12-04-precise-pangolin/
>
> The code can be found at https://code.launchpad.net/openstackbook
>
> We would love to see the book localized in some other languages too, say
> Chinese/Japanese/German to reach to as many people as possible. :)
>
> Suggestion/criticism would be highly appreciated.
>
>
>
>
>
>
> Cheers!!
>
> Atul Jha
>
> Application Specialist
> Csscorp pvt ltd, Chennai, India
>
> http://www.csscorp.com/common/email-disclaimer.php
>
> _______________________________________________
> 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-doc-core
> Post to     : openstack-doc-core@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack-doc-core
> More help   : https://help.launchpad.net/ListHelp
>
>

Follow ups

References