Re: [libvirt] First Virsh command Reference Pages online
----- "Justin Clift" <jclift(a)redhat.com> wrote:
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). :)
great
just note: I didn't implemente the codes to display the domain interfaces
which are attached to the network, it need arbitrary API. probly we
can do it as a next step.. :-)
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. :)