3 Jun
2010
3 Jun
'10
10:31 a.m.
Hi devs,
We have avoided this discussion but it's time to settle it. We need to decide if there
are candidate macros that we should write as wiki macros in our default XE distribution.
And if so what are the rule for deciding whether a macro should be written as a wiki macro
or as a java macro.
Some ideas:
- java macros are much easier to test
- java macros are easier to develop since you have a full-fledged IDE (debugging, syntax
coloring, code validation, etc)
- java macros can obey styling rule, such as checkstyle passing
- wiki macros can be removed so users can't be sure the wiki macro will always be
there since it's only provided with the default XAR
Proposal
=======
- If the macro is a generic macro then it should be written as a Java macro
- If the macro is application-specific (for ex a macro specific to the Blog application)
then it can be written as a Wiki macro
WDYT?
Thanks
-Vincent
3 Jun
3 Jun
11:05 a.m.
New subject: [xwiki-devs] [Proposal] Wiki Macros vs Java Macros in the default XE distribution
On Thu, Jun 3, 2010 at 10:31, Vincent Massol <vincent(a)massol.net> wrote:
Hi devs,
We have avoided this discussion but it's time to settle it. We need to decide if
there are candidate macros that we should write as wiki macros in our default XE
distribution. And if so what are the rule for deciding whether a macro should be written
as a wiki macro or as a java macro.
Some ideas:
- java macros are much easier to test
- java macros are easier to develop since you have a full-fledged IDE (debugging, syntax
coloring, code validation, etc)
- java macros can obey styling rule, such as checkstyle passing
- wiki macros can be removed so users can't be sure the wiki macro will always be
there since it's only provided with the default XAR
And for the pros on wiki macros:
- wiki macro can be easily modified from the wiki when you want to customize it
Proposal
=======
- If the macro is a generic macro then it should be written as a Java macro
- If the macro is application-specific (for ex a macro specific to the Blog application)
then it can be written as a Wiki macro
- when the macro depends on some wiki page then it should probably be
written as Wiki macro (more or less the same thing than your previous
point for more clear than way ;))
WDYT?
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne
11:24 a.m.
New subject: [xwiki-devs] [Proposal] Wiki Macros vs Java Macros in the default XE distribution
On Thu, Jun 3, 2010 at 11:05, Thomas Mortagne <thomas.mortagne(a)xwiki.com> wrote:
On Thu, Jun 3, 2010 at 10:31, Vincent Massol
<vincent(a)massol.net> wrote:
> Hi devs,
>
> We have avoided this discussion but it's time to settle it. We need to decide if
there are candidate macros that we should write as wiki macros in our default XE
distribution. And if so what are the rule for deciding whether a macro should be written
as a wiki macro or as a java macro.
>
> Some ideas:
> - java macros are much easier to test
> - java macros are easier to develop since you have a full-fledged IDE (debugging,
syntax coloring, code validation, etc)
> - java macros can obey styling rule, such as checkstyle passing
> - wiki macros can be removed so users can't be sure the wiki macro will always be
there since it's only provided with the default XAR
- wiki macros don't support typed parameters (yet)
- wiki macros don't support bean validation (yet, but it can be "done by
hand")
And for the pros on wiki macros:
- wiki macro can be easily modified from the wiki when you want to customize it
--
Thomas Mortagne
Proposal
=======
- If the macro is a generic macro then it should be written as a Java macro
- If the macro is application-specific (for ex a macro specific to the Blog application)
then it can be written as a Wiki macro
- when the macro depends on some wiki page then it should probably be
written as Wiki macro (more or less the same thing than your previous
point for more clear than way ;))
WDYT?
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne
11:33 a.m.
New subject: [xwiki-devs] [Proposal] Wiki Macros vs Java Macros in the default XE distribution
On Jun 3, 2010, at 10:31 AM, Vincent Massol wrote:
Hi devs,
We have avoided this discussion but it's time to settle it. We need to decide if
there are candidate macros that we should write as wiki macros in our default XE
distribution. And if so what are the rule for deciding whether a macro should be written
as a wiki macro or as a java macro.
Some ideas:
- java macros are much easier to test
- java macros are easier to develop since you have a full-fledged IDE (debugging, syntax
coloring, code validation, etc)
- java macros can obey styling rule, such as checkstyle passing
- wiki macros can be removed so users can't be sure the wiki macro will always be
there since it's only provided with the default XAR
Proposal
=======
- If the macro is a generic macro then it should be written as a Java macro
- If the macro is application-specific (for ex a macro specific to the Blog application)
then it can be written as a Wiki macro
WDYT?
ok, I've been convinced that there's no simple solution and thus that we need to
decide whether a macro should be implemented in java or as a wiki page on a case by case
basis.
Thus I propose that when a macro is implemented as a wiki macro, we put in SVN in
platform/applications as an application by itself (ie a XAR). In the same manner as java
macros are a JAR by themselves.
WDYT?
Thanks
-Vincent
12:20 p.m.
New subject: [xwiki-devs] [Proposal] Wiki Macros vs Java Macros in the default XE distribution
Le 03/06/10 11:33, Vincent Massol a écrit :
On Jun 3, 2010, at 10:31 AM, Vincent Massol wrote:
We should avoid having one application per macro, otherwise it's going
to be a mess.
I think we should categorize the wiki macros so that we have one
application by big category.
Ludovic
Hi devs,
We have avoided this discussion but it's time to settle it. We need to decide if
there are candidate macros that we should write as wiki macros in our default XE
distribution. And if so what are the rule for deciding whether a macro should be written
as a wiki macro or as a java macro.
Some ideas:
- java macros are much easier to test
- java macros are easier to develop since you have a full-fledged IDE (debugging, syntax
coloring, code validation, etc)
- java macros can obey styling rule, such as checkstyle passing
- wiki macros can be removed so users can't be sure the wiki macro will always be
there since it's only provided with the default XAR
Proposal
=======
- If the macro is a generic macro then it should be written as a Java macro
- If the macro is application-specific (for ex a macro specific to the Blog application)
then it can be written as a Wiki macro
WDYT?
ok, I've been convinced that there's no simple solution and thus that we
need to decide whether a macro should be implemented in java or as a wiki page on a case
by case basis.
Thus I propose that when a macro is implemented as a wiki macro, we put in SVN in
platform/applications as an application by itself (ie a XAR). In the same manner as java
macros are a JAR by themselves.
WDYT?
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Ludovic Dubost
Blog: http://blog.ludovic.org/
XWiki: http://www.xwiki.com
Skype: ldubost GTalk: ldubost
5251
days inactive
5251
days old
4 comments
3 participants
participants (3)
-
Ludovic Dubost -
Thomas Mortagne -
Vincent Massol