----- "Justin Clift" <jclift@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. :)