I am for B) because that's what (I thought) we had agreed upon in the
past. I always understood that doxia is still alpha, that I was allowed
to make changes on trunk, and that we would stabilize the API with the
first beta release. Also, as you say, we have already made some breaking
changes to current trunk (eg DOXIA-137, DOXIA-155), and there are a
number of open bugs whose fix will entail some breakig changes (since in
practice people use hacks to workaround those bugs). However, I haven't
tested recently if beta-1 works with the site plugin (it didn't when I
tried a while ago).
Anyway, in order to push things forward, I would agree to do a 1.0
release from the current alpha branch. I would vote with a belly-ache
though because I feel that for a 1.0-final label there are some
important things missing (DOXIA-123, DOXIA-138, DOXIA-145). OTOH some of
the things that are fixed in beta-1 could well go into a 1.0 release, eg
all the work Dave Syer has done on the confluence module.
I'd first like to hear Dennis' opinion though, he should know best how
things work with various Maven plugins. I haven't had much time for
doxia recently and even though I still plan to do things, I don't think
I can contribute much in the near future...
Cheers,
-Lukas
Vincent Massol wrote:
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 B).
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.
Thanks
-Vincent
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):
* http://jira.codehaus.org/browse/DOXIA-203: Add support for level 6
sections and generalize Sink API for sections
* http://jira.codehaus.org/browse/DOXIA-202: Add an API for getting
a tree of syntax blocks
* http://jira.codehaus.org/browse/DOXIA-165: Add support for macros
* http://jira.codehaus.org/browse/DOXIA-164: Add support for
strikethroughs
* http://jira.codehaus.org/browse/DOXIA-163: Add support for
underscores
* http://jira.codehaus.org/browse/DOXIA-204: Add generic parameters
support to Figure and Link events
* http://jira.codehaus.org/browse/DOXIA-205: Add new standard
parameters to figure sink API
* http://jira.codehaus.org/browse/DOXIA-206: Add new standard
parameters to link sink API
* http://jira.codehaus.org/browse/DOXIA-207: 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