-----Original Message----- > From: Matthew Hartmann [mailto:mhartm...@tls.net] > Sent: Tuesday, June 05, 2012 10:17 AM > To: cloudstack-dev@incubator.apache.org > Subject: Re: [PROPOSAL] Further refinement of CloudStack modules... > > ... > Fantastic! Thanks for the clarification, Alex! As a heavy user of > CloudStack, I would like to propose an addition to your packaging model. > I would like to see a cloud-docs package that includes documentation for > command line utilities that are available on the Management Server. I think > it would also be advantageous to include the Admin & Install guides in HTML > format in a cloud-docs package. Do you think there is any possibility of > that happening? It seems some of the most common questions that come across > IRC and the mailing lists have to do with documentation; it seems the > community could greatly benefit from such a package. > > Cheers, > > Matthew > > Hello Matt,
I'm glad to hear that HTML-based documentation is of interest. To answer your question "Do you think there is any possibility of that happening?" the answer is definitely "yes" as I am working on it right now, along with another contributor, Radhika PC. We will be checking XML versions of the existing CloudStack tech docs in to git, and running it through Publican (Fedora) to create various outputs including HTML. We plan to post the HTML on the CloudStack docs website. We will need a bit of coding to (1) automate our Publican build and (2) automate uploading the HTML to the website. The repos we are using are https://github.com/CloudStack/cloudstack-docs and https://github.com/CloudStack/publican-cloudstack. Of course we will move those onto Apache repos at some point soon. I hope this information is helpful. Jessica T. CloudStack Tech Pubs
