Partly generated right off the JavaDoc, partly generated by hand. The xdoc files contain the examples and notes and are merged into the file generated from the JavaDoc.
For most of the examples, I have a side project that I used to write and test the code and from which I generated the screenshots. It would be cool to build a tool more like the pragmatic programmers, where samples are extracted live from real code (using marker comments). On Feb 6, 2008 6:52 AM, Michael Lake <[EMAIL PROTECTED]> wrote: > The docs look great! > > I've been helping people on IRC ( #tapestry @ freenode.net) and at > least one user found it extremely helpful when I pointed out the > integration test app > located in the following folder(to see working examples): > > tapestry-core/src/test/java/org/apache/tapestry/integration/app1 > > In fact, he came back online to say "I wonder why I didn't find this > info on the site" > > I'm curious about these .xdoc files - how are you creating them? by hand? > I would have expected that example code shown in the component reference > would be generated from actual java/tml which could be part of the > integration test suite. This would help ensure the examples are up-to-date. > > Also, I bet it'd be possible to have syntax highlighting for the code. I > know that'd > probably be a back-burner item, but I can picture newbies coming to the > site and > getting the feeling that the docs are bland and colorless. > > ...just ideas.. > > Keep up the good work! > > -mike > > > > Filip S. Adamsen wrote: > > Fully agree. Thumbs up! > > > > -Filip > > > > Geoff Callender skrev: > >> Wow! That was sooooo worth doing. Nice work. > >> > >> Geoff > >> > >> On 06/02/2008, at 3:41 AM, Howard Lewis Ship wrote: > >> > >>> I've extended the component reference to allow images as part of the > >>> documentation ... so far, its all screen shots. > >>> > >>> http://tapestry.formos.com/nightly/tapestry5/tapestry-core/ref/index.html > >>> > >>> > >>> Feedback still encouraged! > >>> > >>> -- > >>> Howard M. Lewis Ship > >>> > >>> Creator Apache Tapestry and Apache HiveMind > >>> > >>> --------------------------------------------------------------------- > >>> To unsubscribe, e-mail: [EMAIL PROTECTED] > >>> For additional commands, e-mail: [EMAIL PROTECTED] > >>> > >> > >> > >> --------------------------------------------------------------------- > >> To unsubscribe, e-mail: [EMAIL PROTECTED] > >> For additional commands, e-mail: [EMAIL PROTECTED] > >> > >> > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > -- Howard M. Lewis Ship Creator Apache Tapestry and Apache HiveMind --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
