[libvirt] First Virsh command Reference Pages online

[Justin Clift]

On 12/11/2010, at 9:38 AM, Osier Yang wrote:
> looks pretty good, though missed "net-info", it still need to be ACKed.. :-)

Yeah, trying out the net-info patch is on my list of things to try today (time dependant). :)

The code looked pretty straight forward from a visual inspection, so I'm not thinking there will be any problems with it.


>> We can output to multiple formats (html, single-page-html, pdf, epub, txt), so it's probably a decent idea
>> to put the downloadable ones somewhere, and have the html pages viewable online.
>> 
>> My initial thinking is adding the downloads to the Downloads page, with the files themselves in the libvirt FTP area.
>> 
>> Something like:
>> 
>>   ftp://libvirt.org/libvirt/virshcmdref/<stuff>
>> 
> 
> also git repo?

Very good point yes.  And probably also worth including my email address under it directly, as it's easier than people having to go through the mailing list sign up process.  (same thought for the App Dev Guide and David Jorm's email)


>> Unsure what a good menu placement for the online html pages are though.  This is just the first few commands, and
>> not a "widely comprehensive" reference thing yet.
>> 
> 
> will it be fine as a submenu of top "Documentation" memu? the
> development guide is there, as Daniel P.Berrange said, probly
> these docs will be part of "Admin guide". If so, it's reasonable
> to put there IMHO.

Submenu of top Doc menu, yeah, that's probably workable.

Thanks Osier. :)