incubator-cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Matthew Hartmann <mhartm...@tls.net>
Subject Re: FW: [PROPOSAL] Further refinement of CloudStack modules...
Date Wed, 13 Jun 2012 12:36:20 GMT
Jessica:

That's great to hear! Thanks for the update. :)

Cheers,

Matthew



On 6/13/2012 4:09 AM, Jessica Tomechak wrote:
> -----Original Message-----
>
>> From: Matthew Hartmann [mailto:mhartmann@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
>




Mime
View raw message