[Pkg-virtualbox-devel] Bug#484998: Bug#484998: suggestion for README.Debian

Michael Schmitt mschmitt at unixkiste.org
Mon Jun 9 11:53:55 UTC 2008


Am Montag, den 09.06.2008, 10:32 +0200 schrieb Michael Meskes:
> > I think everyone installing virtualbox-ose on debian will have the
> > README.Debian and the other documents provided with the package but not
> > necessarily net access. And of course, if it helps others to implement
> > ...
> I tend to agree with your message and Hilko's subsequent reply. How
> about adding the wiki page to /usr/share/doc/virtualbox-ose? I'd prefer
> to keep stuff in the wiki where a lot of people can edit and improve it
> instead of moving everything to a README in the source tree. Comments?
> Michael

Hmmm... maybe a good option, maybe not. I think not every aspect of
"documentation" needs to be included in the package itself but IF there
is enough free documentation it could be a viable step to built a
doc-package and deliver it seperately (virtualbox-ose-doc). But then
again, dunno... I heard rumors it _may_ be that Innotek may release the
official documentation under a free enough license in the not so near
future, no facts though. But if that will happen, that documentation
should be provided as a seperate doc-package and if by that time already
a comunity contributed doc package (dump of the wiki) is there, it will
confuse people.
Another thing, I only want "high quality" documentation in debian. I
don't want to say my little "bridge cookbook" is of that quality but
then again it is just something to get it up and running without a
headache, but if there is no good and real and free documentation then
there IS NO documentation to be included... up to now.
That said, I tend to suggest including just the necessary docs to get
things up and running and wait (haha) till the official docs can be
included. If it is certain that this will not happen, let's say till it
could be included in lenny-stable, including "something" may be better
than nothing and the free comunity contributed docs should be included /
built as virtualbox-ose-doc.

Many ifs, maybes, coulds... I know.


More information about the Pkg-virtualbox-devel mailing list