← Back to team overview

openstack-doc-core team mailing list archive

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

 

Hi Lorin,
I agree. The only thing I think about would be the google tracking, or some sort of tracking tool in order to be up-to-date. Sometimes though, these are just copy and paste from other websites, making the tracking efficiency harder ?

As for the page, it is a great idea I think, a sorting by "profile" would make sense : - New to OpenStack (-> Starter Guide/ Schemas/ Implementations/ Abstract)
- You run an OpenStack cloud (-> Deployment, Admin guides, Blueprints)
- You are a developper (Abstracts/ Schemas/ API books)
Razique

On 12 May 2012, at 3:23, Lorin Hochstein 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


References