On Sun, May 27, 2012 at 7:14 PM, Tibor Mlynarik <[email protected]> wrote: > New site looks fresh !
I agree... And considering it is all statically generated with mostly plain text files --> Not too scabby... > I see that content is mixing target versions 1.4 ( i.e. Concepts > section ) and 2.0 ( i.e. Core ). I think it can confuse a newcomer. As Paul said, it should all be 2.0. But not only that... I would like to make sure that every single piece of "sample code" in the documentation is pulled from an actual source file (preferably a test) via the "snippet" feature, to ensure that any refactorings are propagating into the docs as well. Major feature by itself... And I have started here and there, and you can probably spot testclasses called "DocumentationSupport" or something similar, which indicates the role. > First example ( Concept/Abstract Mixin) that I see when starting with > concepts has error: As said above; We *should* start porting all sample docs into actual test code that get run and part of refactorings. It is actually fairly simple to do, just takes some time... Thanks for reporting it... Really appreciated. Dig in and make it happen ;-) I'll buy beer next time you come to Shanghai. Actually, I will extend that to everyone on this list; !!! Anyone that contributes ONE Recipe/HOWTO, a "concept" write up, documentation of a Library or similar amount of documentation, will get an "all beers on me" night when you visit Shanghai next time ;-) 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
