"Nathan Bubna" <[EMAIL PROTECTED]> writes:
>perhaps we should rename the guides on the website to prevent such
>confusion. essentially, the "User Guide" teaches people how to write
>templates in VTL. the "Developer Guide" teaches people how to develop
>applications that use Velocity.
>i haven't thought long about better names, but perhaps something along
>the lines of:
>User Guide -> How to Write Templates
>Developer Guide -> How to Use Velocity
>better name ideas are welcome...
Nathan,
these are excellent ideas. One of the first things that I did was to
take stock of the existing docs and put them into a mind mapping
tool. I can really recommend Freemind (freemind.sf.net) which is open
source and free.
>and as a bonus thought: you could probably break the Developer Guide
>into two guides, one more focused on using Velocity and another on the
>configuration minutia (which is not even fully documented). then we
>could have guides on: Writing Templates, Using Velocity,
>Configuration Options.
Hm. I'd think that the developers guide should focus on "programming
with Velocity" and the "how to configure Velocity" is basically an
Appendix to it. One of the problems with many xdoc driven sites is,
that documentation is spread out too thin over many pages.
Best regards
Henning
--
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen INTERMETA GmbH
[EMAIL PROTECTED] +49 9131 50 654 0 http://www.intermeta.de/
RedHat Certified Engineer -- Jakarta Turbine Development -- hero for hire
Linux, Java, perl, Solaris -- Consulting, Training, Development
Social behaviour: Bavarians can be extremely egalitarian and folksy.
-- http://en.wikipedia.org/wiki/Bavaria
Most Franconians do not like to be called Bavarians.
-- http://en.wikipedia.org/wiki/Franconia
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
