> > -----Original Message----- > From: Wido den Hollander [mailto:w...@widodh.nl] > Sent: Wednesday, August 08, 2012 2:10 PM > To: cloudstack-dev@incubator.apache.org > 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 >
