This is definitely a start. But when I looked at making my own changes
to the DITA files, it made my head spin. There are all these files with
strange names, and no real clear idea how they all fit together. Then
you have to purchase or download a DITA editor (with no clear
recommendation, just a list of options, many of them having a cost), or
edit in raw XML. The whole thing is a bit mystifying to me.
I understand the value of being able to generate HTML and PDF documents.
But it really impacts the ability for a novice to update the
documentation.
I think those in the docs area who are tired of checking in other
people's changes perhaps might be motivated to write a tutorial showing
how to do this, and to provide a single recommendation for a good *free*
DITA editor. :)
David
Andrew McIntyre wrote:
On 8/14/06, Daniel John Debrunner <[EMAIL PROTECTED]> wrote:
I was planning to commit some of the outstanding documentation patches,
e.g. DERBY-1548, but I realised I have no idea how to do this.
Looking at the download site there's no mention of the documentation
source code:
http://db.apache.org/derby/derby_downloads.html#Derby+source+code
I couldn't see anything in the wiki on how to download the svn source
for the documentation, build it (? I know it needs DITA, but that's
about all I know), and test it.
Seems like we could get documentation patches in quicker if all the
committers could handle them, rather than the the two or three who
submit these patches today. Let's scale with the size of the community.
Is there a write-up somewhere on how to do this?
There is this page, which should describe most of what you need:
http://db.apache.org/derby/manuals/dita.html
It's hiding in the drop-down box off the left when you click the
Documentation tab as "DITA source". I think a link from the main
documentation page might help make this easier to find.
andrew
