hallo adam, a modern way of doing docs for an open-source project ... but you dont get it for free.
my recomendation: [this may still not be the right way to go, but ...] *step 0* put this under investigation: http://svn.codehaus.org/grails/trunk/grails-doc *step 1* ask graeme or peter, if they want to share information about their experiences doing docs the grails way. -> motivations, advantages, disadvantages *step 2* after going step 1, ask yourself, if this is a right way to do gradle-docs too. if so publish a proposal at gradle-dev mailinglist. important point: migration of latex-doc *step3a* ask graeme and peter, if they would support factoring out the core of grails-doc into a separate codehaus project. *step 3b* if you still want to do it and developers accept the proposal, start migrating docs. *step 4* after successfully completing the switch of gradle-docs have a drink on graeme ... ;-) grüsse Adam Murdoch-2 wrote: > > Helmut Denk wrote: >> some smart people who put a doc-dsl in front of >> latex, itext, xhtml+css ... whatever can become >> heroes IMO because with a dsl you can easily: >> >> - bridge the gap between static and dynamic content >> - solve the modularity-problem >> - solve the multichannel-output-problem >> - make authoring a simple task >> >> to produce xhtml+css would be the most simple >> solution for the start. you can produce very nice >> pdf from xhtml+css. there are even books made >> like this. >> >> > > This would be excellent if it existed. I am not even slightly interested > in inventing it. > >> i think graeme rocher has started a doc-dsl for the >> grails-reference-guide. but grails is not the right context >> to solve this. >> > > --------------------------------------------------------------------- > To unsubscribe from this list, please visit: > > http://xircles.codehaus.org/manage_email > > > > -- View this message in context: http://www.nabble.com/ditch-latex--tp20196953p20261239.html Sent from the gradle-dev mailing list archive at Nabble.com. --------------------------------------------------------------------- To unsubscribe from this list, please visit: http://xircles.codehaus.org/manage_email
