On Tue, Dec 1, 2009 at 16:49, Fabio Mancinelli
<fabio.mancinelli(a)xwiki.com> wrote:
On Dec 1, 2009, at 4:28 PM, Thomas Mortagne wrote:
Hi all,
Since i finished a first POC, I would like to introduce a new XML
based syntax. the goal is to provide an easy to parse exact mapping of
the rendering events.
You can look at
http://dev.xwiki.org/xwiki/bin/view/Design/xmlsyntax
for more details.
Would be great to have comments about this.
The main things to discuss are:
- what XML syntax exactly
(
http://dev.xwiki.org/xwiki/bin/view/Design/xmlsyntax#HProposedformat)
Just a remark, why not using names for parameters?
This would make the format more robust wrt evolutions.
Currently the order introduces a stronger coupling with the beginEvent semantics for a
given event.
Using names, this would not be the case anymore (and as a side effect debugging would be
easier).
I hesitated but as i said in the proposal, having names also mean
having mapping between this name and where is it in the event, mapping
which does not exist currently.
Note that parameters are not internal implementation details, it's a
public API used by both parsers and renderers so changing it is not
that easy.
I agree that adding the name information could be useful but it makes
parser and the renderer doing more logic and make the format more
verbose (it would be the first "in case of" information in the format)
and I'm not sure it's really needed. From technical POV, it just make
possible to randomize parameters instead of always have them in the
same order.
I'm 50/50 on this, if others think it's really important i can start
to introduce more information in EventType enum.
-Fabio
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne