maven-doxia-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Vincent Massol <>
Subject Re: Breaking changes on Doxia trunk ok?
Date Wed, 23 Jan 2008 07:37:28 GMT

On Jan 22, 2008, at 11:31 PM, Jason van Zyl wrote:

> I think you should cut the 1.0 and then move on. You will completely  
> hose the site plugin will you not?
> I'm all for changes. I want them but this can't happen before a 1.0.

I'm fine with either of these options:

A) Create a 1.0 branch so that work can be finished for 1.0 and make  
trunk 1.1/2.0. I'll commit on trunk then.
B) Commit on trunk right now since Maven uses alphas of doxia and  
there's an alpha branch for maven. And since I believe trunk is  
already not working with maven.
C) Leave trunk for 1.0 and create a 1.1/2.0 branch so that I can  
commit there while waiting for the 1.0 version to be released and then  
merged back everything to trunk

My preference goes to A) but I'm ok also with C). I know Lukas prefers  

Just let me know what I should do. Only thing that's sure is that I  
don't have close to enough knowledge/bandwidth to help with the 1.0  
release. The other sure thing is that I need a place to commit ASAP  
since I'm stuck right now and I'll loose my momentum if I don't have a  
place to commit. I really need to make quick progress to be aligned  
with xwiki's needs.


> We have to make something for the site plugin to use.
> On 22-Jan-08, at 5:02 AM, Vincent Massol wrote:
>> Hi,
>> I'm just starting development on Doxia and I need to understand the  
>> strategy since I need to make lots of breaking changes to  
>> accomodate the XWiki use cases (I'm planning to replace XWiki's  
>> rendering engine from Radeox to Doxia).
>> I've just talked to VincentS and Lukas and the consensus I got was  
>> that I could just commit away on trunk and make breaking changes  
>> since:
>> a) 1.0 has not been released yet and the API is not final and thus  
>> it's the right time to do this
>> b) there an alpha branch that the current Doxia users (like Maven  
>> itself) can use id they don't want to upgrade to the changes made.
>> So I'd like agreement that I can make my changes on trunk. Namely  
>> I'd like to implement these (and more to come):
>> * Add support for level  
>> 6 sections and generalize Sink API for sections
>> * Add an API for getting  
>> a tree of syntax blocks
>> * Add support for macros
>> * Add support for  
>> strikethroughs
>> * Add support for  
>> underscores
>> * Add generic parameters  
>> support to Figure and Link events
>> * Add new standard  
>> parameters to figure sink API
>> * Add new standard  
>> parameters to link sink API
>> * Add events for  
>> recognizing words in the Sink API
>> WDYT?
>> Thanks
>> -Vincent
> Thanks,
> Jason
> ----------------------------------------------------------
> Jason van Zyl
> Founder,  Apache Maven
> jason at sonatype dot com
> ----------------------------------------------------------
> A man enjoys his work when he understands the whole and when he
> is responsible for the quality of the whole
> -- Christopher Alexander, A Pattern Language

View raw message