Open Stack

HI Kev,

I'm pretty new at the formal document thing too.  I'd recommend first
getting the source and seeing that you can make that build into
documents which took a little bit of doing for me as I had none of the
necessary tools. http://wiki.openstack.org/Documentation/HowTo which
you've probably already found has all the gory details of acocunts and
git workflow etc. etc.

I suspect most people of using fancier tools, but coming from a
Sysadmin cum Dev/Ops background I just fired up my favorite text
editor and used existing documentation as a guide to what markup to
use.  If you're familiar with XML (even just a little) then it's not a
big deal, well at least making edits to existing docs like I have been
isn't.

For what to do sift through
https://bugs.launchpad.net/openstack-manuals for something that looks
simple to you and just go for it, I'm sure if you have any questions
as you hit bumps along the way people here would be happy to answer.

-Jon

On Fri, Aug 10, 2012 at 4:49 AM, Kevin Jackson
<kevin at linuxservices.co.uk> wrote:
> Howdy fine folk,
>
>>
>> On Aug 5, 2012, at 3:20 PM, Anne Gentle wrote:
>>
>>
>> I've been talking to Debra at Pearson, on the To: line (Hi Debra!) and we
>> are looking for authors for some of the operations chapters to be part of a
>> larger book about running and deploying OpenStack. So I would love for you
>> to start as author but want to be sure it's okay that the license is such
>> that we're sharing those chapters with Pearson for a larger book. The
>> outline is http://etherpad.openstack.org/EssexOperationsGuide for the
>> operations part, and Doug Hellman and I have worked on an outline for the
>> "Developing" part at http://etherpad.openstack.org/PythonDevBookOutline. The
>> two together comprise a book proposal for Pearson.
>>
>
> So, how do I get started with this Operations Manual and contributing?
> I have no idea of DocBook and all the other good stuff you wordsmiths seem
> to endure?/love ;-) but have a lust to share some knowledge.
> I appreciate I'm a little late to the game, but if there's a OpenStack Doc
> 101 somewhere and some stuff you'd like to assign to me, let me know.
> (In terms of some time to do this - sporadically during next 6 weeks as I
> wrap up that other project involving writing, after that, hit me).
>
> Cheers,
>
> Kev
> --
> Kevin Jackson
> @itarchitectkev
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>