incubator-cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jessica Tomechak <>
Subject Re: Writing documentation, where?
Date Wed, 08 Aug 2012 23:51:57 GMT
> -----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...
> 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?

I suggest it would be great to set up a staging server for our doc reviews.
Any review request for a doc patch should be able to include a URL to a web
page where the output can be seen. Can anyone suggest to me how to set this
up within Apache infrastructure? I have never been in charge of setting up
such a thing before so help would be appreciated very much.

> 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

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message