incubator-cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Wido den Hollander <>
Subject Re: Writing documentation, where?
Date Thu, 09 Aug 2012 13:23:46 GMT
On 08/09/2012 01:55 AM, Jessica Tomechak wrote:
>> -----Original Message-----
>> From: Wido den Hollander []
>> Sent: Wednesday, August 08, 2012 2:10 PM
>> To:
>> Subject: Writing documentation, where?
>> Hi,
>> Chip's e-mail about the 4.0 release woke me up, I still had to write some
>> documentation...
> Wido,
> I also have a lot to do getting documentation ready for 4.0! Thanks very
> much for speaking up. This will be our first test run with multiple
> contributors and using Publican on CloudStack docs. Should be interesting!
> The help is very much appreciated.

Thanks for your very detailed e-mail, overwhelmed me a bit :)

As the 'docs' directory seems to be the location for docs I'll start there.

My first idea is to get publican actually build some docs locally..

wido@wido-desktop:~/repos/cloudstack/docs$ publican build --formats test 
--langs en-US --config=publican-all.cfg
Failed to load brand file: 
/usr/share/publican/Common_Content/cloudstack/publican.cfg at 
/usr/bin/publican line 647

I'll probably get back on this somewhere next week.

You asked about what I wanted to document:

1. RBD integration for CloudStack
2. Setting up an Agent with 4.0, using the UI, cloud-setup-agent and 
3. Upgrading your Hypervisor from 3.0.2 to 4.0

Give me some time, as my inbox is flooding with new e-mails about all 
kinds of stuff :)


> Jessica T.
> CloudStack Tech Pubs
>> For 2.2 and 3.0.2 there is a Installation Guide, but where did that come
>> from? (What source) Are we going to maintain it for 4.0?
>> In the repository there is /docs and I guess that is the right place?
>> These are all DocBook XML files, but I can't find a Ant target for it?
>> How do I turn these XML files into viewable HTML files so I can verify
>> them?
>> Is this the place to document everything or are we going to maintain a
>> Wiki?
>> I want to update the documentation about configuring/adding a Hypervisor
>> host, the system requirements, using RBD and probably other stuff I'll find
>> along the way.
>> This is just one of the dots I'm still haven't connected.
>> Wido

View raw message