← Back to team overview

maria-developers team mailing list archive

Re: Documentation for new features in MariaDB

 

On Fri, Aug 14, 2009 at 10:30 AM, Kristian
Nielsen<knielsen@xxxxxxxxxxxxxxx> wrote:
> Henrik Ingo <henrik.ingo@xxxxxxxxxxxxx> writes:
>
>> Now that I think about it, maybe this part of the documentation effort
>> could for the time being be done as a diff against the MySQL manual.
>> (Which is DocBook?)
>
> Have you checked the implications of the copyright/license issues for this
> idea?

So we couldn't touch the actual MySQL manual - and I don't know if a
diff actually makes sense then. The diff itself I'm sure would turn
out to be legal, otoh if it would be technically required to have a
copy of the MySQL manual at hand just to write MariaDB
documentation... Now that I think about it it sounds like a stupid
arrangement anyway. (I still think it would be legal.)

Maybe calling it a "delta" is better, ie we would try to place things
in the same chapters etc, but write our docs as an independent text,
not a diff. Logically it is still like a "diff", in the sense that the
reader is expected to first read the MySQL manual, then our additional
documentation. Also the choice to use the same format as the "parent
manual" would still make sense in this approach.

Just to make it clear: Over time we of course need to have a full
independent manual of MariaDB, which can then be in any format and
written with any tools our technical writers prefer.

henrik
-- 
email: henrik.ingo@xxxxxxxxxxxxx
tel:   +358-40-5697354
www:   www.avoinelama.fi/~hingo
book:  www.openlife.cc



Follow ups

References