Re: AWare

Jonas Boner wrote:

>What about the namespace for the classes? What do you think is best to do?
>
>    Can we wait with this a couple of days?
>  
>
Sure, it won't be hard to refactor this with IDEA :-)

>I'll keep working on the unit-tests so that they cover as much code as 
>possible.
>
>    Great. This should be a criteria for check-in.
>  
>
I have reach 70% of code coverage which seems quite good when looking at 
the results from Clover.

>Next, I will probably start to write some doc somewhere on how to use 
>it. BTW what would be the best format for it? xdoc? sdocbook?
>
>    AspectWerkz uses xdoc. Personally I am fond of docbook, but that is more complex. We need a format that can be easily used by any user. I guess xdoc is better. Another alt. would be the confluence wiki. What do you think?
>  
>
xdoc is quite easy but I find it a bit more restrictive on customization 
than docbook. moreover transformation is not done using XSLT but Jelly 
scripts which my be an issue later on if we need to do something "advanced".
confluence would be the easier step for me as my website is run with 
SnipSnap: I suppose there is a simply way to migrate the content.
I think we need to think in terms of deliverables for the doc: HTML 
version? PDF version? or a wiki (à la Hibernate)?
My preference would probably be for docbook too, but I do not know if 
many developers know docbook. BTW there is probably some good WYSIWYG 
docbook editors?

Jérôme.