forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Steven Noels <>
Subject Re: [proposal] refactored markup help docs
Date Wed, 07 Aug 2002 21:56:29 GMT
Ian Atkin wrote:

> basic idea:-
> - to combine hand written help/reference docs with nekodtd generated info
> - "markup" get's it's own area

"tab" I presume?

>    - normal <document>s covering design, version control, validity 
> mechanisms, etc
> - each public identifer/namespace to have a menu
>    - some normal <document>s about the doctype in general (intro, 
> future, issues, etc)
>    - each element get's a link/page, similar to current dtd-docs file 
> but with text descriptions, examples, processing expectations, etc

every element might perhaps overdo it

> current situation:-
> - basically did this to learn cocoon + forrest dtd/sitemap/skin, 'cos i 
> couldn't fathom the tab linking bug (the best headache i've had in ages :-)
> - i have a horrible hack of a solution on my hard drive (couple of xslt 
> scripts, sitemap matches, ...)
> - need to discuss the implementation issues

feel free - even if it is hacky

> if the idea's good and the impl probs can be ironed out i'd have no 
> trouble contributing patches/maintaining the docs
> what do folks think?

fire at will :-)

more DTD docs are always welcome!

thanks, Ian!

Steven Noels                  
Outerthought - Open Source, Java & XML Competence Support Center            

View raw message