At 01:30 7/2/01 +1100, Conor MacNeill wrote: >As Jesse Glick has pointed out, the index.html file is too large and also >difficult to maintain. I think our long term direction is to have some form >of structured documentation system, perhaps based on stylebook or Anakia. I >don't know enough about those yet to know what is reasonable or applicable.
both/either are reasonable and applicable IMHO ;) Just as long as some one takes charge of keeping process done. If we go with stylebook then I can handle that (mainly playing with xslt) however anakia is fine (and faster) if we just use the jakarta-site2 as a dependency. Thou if we want to transform arbitrary xml docs (ala taskdocs DTD instances) then we need someone who is happy to work with velocity which looks simple enough. >In the interim, I have reworked index.html into a collection of HTML files, >one per task. You can find my updated version here > >http://jakarta.apache.org/~conor/ I like it ! Great work .. must of taken a while ;) >At this time, the major change you will notice is on the "built-in tasks" >link. Note that the heading still exists in main document. >A similar approach for optional tasks is of course possible. and very desirable ;) >I am looking for feedback on this approach and whether we should adopt this >for the 1.3 release. I think it would be a good idea though it is largely up to you being that you are release manager ;) Cheers, Pete *-----------------------------------------------------* | "Faced with the choice between changing one's mind, | | and proving that there is no need to do so - almost | | everyone gets busy on the proof." | | - John Kenneth Galbraith | *-----------------------------------------------------*
