A quick update that I've been remiss in sending (had trouble finding
this thread).
The DITA team wants to release the Toolkit under the Apache license. As
soon as it's available under the ASL, I'll pull in the files that the
Derby docs need.
-jean
Jean T. Anderson wrote:
I've discussed this issue with one of the Derby mentors who recommends
that we ask the author of commonltr.css to license that particular file
to the ASF under the Apache License.
All that is needed is for the author to post a note to that effect to
derby-dev.
I'll work with Jeff on this.
-jean
Jean T. Anderson wrote:
I wasn't reading Jeff's email closely (my apologies).
We aren't talking about any xsl stylesheets that DITA uses for the
transformation that produce the output files.
We're talking about the cascading stylesheets used for display. They
don't need to be checked into svn, they just need to be accessible by
the html files that comprise the manuals. Jeff proposes putting the
stylesheet in each manual's output directory. Physical details: on
minotaur, this means copying the stylesheet into each
/www/incubator.apache.org/derby/docs/{adminguide, devguide, getstart,
ref, tools, tuning} subdirectory.
There's probably a precedent for this at Apache that would confirm if
this is alright or not. Does anyone know for sure?
-jean
Jean T. Anderson wrote:
A quick summary (Jeff, correct me if I mangled any meaning) is:
- A DITA style sheet produces a pleasing format for Dreby manuals
- Jeff's tweak of that style sheet improves the format even more
The DITA toolkit is under the CPL license, and modifications to any
of these files create derivative works under CPL. I asked
legal-discuss back in March about checking files under a CPL license
into the apache SVN repository, and the answer that came back was a
strong "No"; I sent the status to derby-dev, see:
http://mail-archives.apache.org/mod_mbox/db-derby-dev/200503.mbox/[EMAIL PROTECTED]
So, these files cannot be checked into svn.
However, anyone who builds the docs is free to use that style sheet.
One option might be to make the style sheet available for download
from a public site outside apache. --This was an approach Ross
Gardler originally proposed for a DITA plugin for forrest when he
offerred to host it at Burrokeet, see:
http://mail-archives.apache.org/mod_mbox/forrest-dev/200503.mbox/[EMAIL PROTECTED]
Anyhow, let's think about the "right apache way" for us to achieve
what we need -- and Derby mentors on this list should feel REALLY
free to chime in with your sage advice and experience.
-jean
