On Tue, May 29, 2012 at 10:35 PM, Tibor Mlynarik <[email protected]> wrote: >> Why not use several snippets? >> >> For example, you could define a tag used in several files and then insert >> multiple [snippet,java] in the asciidoc file. >> > > only objection is that it generates multiple blocks and it doesn't look nice.
I object. I think multiple blocks are "better", so that there is enough space for proper explanation before/after relatively short chunks of code. Long listings in tutorials are typically skipped. Try to keep as much code as possible "runnable", since a fair deal of Qi4j is resolved in runtime (not compile time), so to avoid "embarassing" comments from users, saying "Hey, I copied this piece of code and it throws the following exception in runtime, why?" kind of questions... But I really appreciate your intended effort, so if you insist on doing it "your way", I will not revert any progress.... ;-) Cheers -- Niclas Hedhman, Software Developer http://www.qi4j.org - New Energy for Java I live here; http://tinyurl.com/3xugrbk I work here; http://tinyurl.com/6a2pl4j I relax here; http://tinyurl.com/2cgsug _______________________________________________ qi4j-dev mailing list [email protected] http://lists.ops4j.org/mailman/listinfo/qi4j-dev
