John Levon wrote:
On Thu, Feb 26, 2009 at 09:38:33PM -0700, James Adams wrote:
The correct response to this (since you work for Sun) is to file bugs or
find the right people to fix the problems you see.
There is no bug, just a missing document which I previously found useful. Can you provide or point
me to a list of the right people who'd be willing to field xVM questions from a beginner (other than
this mailing list)? I imagine that such people could have saved me many frustrating hours, if not
days, over the past couple of months, especially considering that my difficulties were probably
child's play for anyone who knows xVM reasonably well.
> But you're looking at
the Wiki on opensolaris.org. Sadly this is not a good place to be
looking.
The good documentation for xVM is difficult to find using Google, and the document I found worked
for me the first time. Thanks to you I now have a better idea of where to look for more complete
documentation.
At this point, the best solution is to remove old docs from the
Wiki, not keep them around like a bad smell.
Or replace them with up-to-date information if the topics are still of interest to the community.
Instead of vanishing the document in question it would be better to simply replace the out-of-date
information with something like a pointer to
http://dlc.sun.com/osol/docs/content/SYSADRM/gfwrk.html#ggdmn
(I'd actually prefer to disable everything that's not known to be
current, but this has obvious problems.)
1. Go to Google and type in "solaris xvm documentation", and the first page
it lists is this one:
http://opensolaris.org/os/community/xen/docs/developers/. That's an
You want us to fix Google? Come on.
My point was that most folks use Google to find what they're looking for, and Google is usually
smart enough to show the most relevant pages at the top of it's search results. You might consider
making it so that Google has an easier time finding and indexing the most appropriate documentation
for Solaris xVM. Perhaps I'm spoiled by not having to deal with this issue with most of the other
open source software I use, their documentation shows up right at the top of a Google search. For
example try "spring framework documentation" and look at how easy it is to find the most
authoritative reference material for Spring. It's up to you guys to decide if you want your
documentation to continue to be difficult for new users to locate, and hopefully I'm doing you a
favor by pointing out that it is.
2. On that page click on bullet #5, "Booting". This should be the place to
find out how to boot Solaris into xVM mode.
That's a dangling reference that we need to fix. The whole doc is kind
of pointless though - it should probably refer to the docs mentioned
below.
Agreed.
Is there better xVM documentation available other than what I found above
and the virsh/xvm man pages? I find it almost impossible to believe that
there isn't, probably I've just not found it. If so then someone please
clue me in so I can stop bothering this list with my newbie questions.
Go to docs.sun.com and type xvm in the search box. The first two links
are what you want. If those don't answer your questions well enough,
please file bugs.
Thanks. Is "hard-to-find or insufficient documentation" really considered to
be a bug?
--James
_______________________________________________
xen-discuss mailing list
[email protected]
