On 3/15/07, Michael Thayer <[EMAIL PROTECTED]> wrote:
> Hello Alexey,
>
> Alexey Eremenko wrote:
> > As you might know, I have already written documentation for
> > VirtualBox-on-SUSE. (and submitted for SUSE 10.3 inclusion).
> > And a very good one.
> Would you like me to include it in the HOWTOs?

As you wish. But keep in mind that my documentation is *much more*
than a HOW-TO.

It is a step-by-step setup guide covering many things, including
basics, overall theory, networking, USB, troubleshooting, porting VMs,
....

Feel free to read it. Many people like it.

>
> > I'm willing to participate in writing of this community documentation
> > with only one requirement - it will be available offline - that is:
> > with product installation on PCs that are *not* connected to the
> > Internet. Internet-online documentation does not fulfill my needs.

> Do you mean by this that it it freely downloadable, or actually included
> in the default install?  The first should be OK if people submit under
> the MIT licence (technically if they submit under the contributor
> agreement as well, but for politeness sake I would prefer the first).
> The second might be doable as well, but we would have to think about it.

The second - included with default install, and fully integrated with
the product.

Fully integrated means there are links to user-docs, from Windows OS
start menu + from VirtualBox itself.

On my part, I'm willing to update the documentation, and keep it
high-quality overall.

I also think that if someone's documentation isn't updated/or is of
low-quality, it should be kept away from the product. That means,
available from online only. This rule applies to my documentation too,
of course.

> You can always submit patches to the official documentation.

I think your official documentation is written in DocBook XML...
Is there any InnoTek guide to setup the development environment correctly ?
I have done it for SUSE, according to docs provided by Novell, but
InnoTek environment will be different.
Or you want me to make a "hack" and send patches in plain-text format?

> Platform-specific stuff may be better as HOWTOs.

For major platforms, the stuff really better to be integrated. Of
course, the documentation will be properly devided into sections, like
you did in the official documentation.

Windows 2000/XP and openSUSE are such major platforms. (perhaps
Debian/Ubuntu/Fedora as well). You have additional need to support
RHEL.
Esp. section 10.4.x

Thanks Michael

_______________________________________________
vbox-users mailing list
vbox-users@virtualbox.org
http://vbox.innotek.de/mailman/listinfo/vbox-users

Reply via email to