baerrach wrote:
>
> On Sun, Apr 13, 2008 at 2:24 PM, Jason van Zyl <[EMAIL PROTECTED]> wrote:
> There are other sadists around, but we'd like to here from Tim to compare
> notes.
>
> Writing good quality documentation that is properly linked, with
> examples taken from real working code/systems is bloody hard. Any
> links/suggestions on how to do this better are always welcome.
>
>
Very true. Just as an example I have to write a data model documentation
with diagrams and sample SQL queries. So I have external SQL files that I
actually execute as part of the build using the sql plugin. That way if the
schema changes, the build breaks and the documentation will hopefully be
updated...
--
View this message in context:
http://www.nabble.com/Definitive-Guide---is-it-real--tp16656704s177p16670485.html
Sent from the Maven - Users mailing list archive at Nabble.com.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
