Hi, Shreyas,
Writeups are so very much appreciated! Especially writeups that can be integrated into the derby web site with a minimum of fuss.
For adding new content to the derby web site, the writeup below is intended to help people test new content and also help committers understand how to commit changes:
http://incubator.apache.org/derby/papers/derby_web.html
Currently the site uses forrest 0.6. The forrest project will release 0.7 soon, so I opened a task to upgrade it to 0.7 -- see http://issues.apache.org/jira/browse/DERBY-188 -- but I haven't started looking at 0.7 yet.
For improvements to the DITA doc source, see http://incubator.apache.org/derby/manuals/dita.html .
regards,
-jean
Shreyas Kaushik wrote:
Hi all,
As people on this alias might know there was a thread running where we discussed about debugging the test failures in the Derby harness. I plan to do a write up of my learnings in the process ( also has some valuable suggestions from Kathey ).
I was wondering where to start? Things like,
~ How do I work with the new Apache Forrest ? Is it like adding stuff another HTML document ?
~ Where to find the actaul docs source to start playing with ?
~ What section to put this write up in ?
~ How do I test my write up ? ( Formatting, font size..etc )
Any pointers on these would help. I hope this document will a be a good one for beginners and people not so familiar with the Derby test framework ( I am also learning ).
~ Shreyas
