17 Feb
2010
17 Feb
'10
12:18 p.m.
On Wed, Feb 17, 2010 at 11:35, Jerome Velociter <jerome(a)xwiki.com> wrote:
I don't agree with that, using strings generate a lot's of bugs. We
are supposed to write good application so we should use proper APIs
and anyway better give references based examples than string based
examples.
Also reference based code is not unreadable when already written it's
just a little more difficult for the use to know how to create the
proper reference to deal with reference based APIs.
On Wed, Feb
17, 2010 at 10:45, Jerome Velociter <jerome(a)xwiki.com> wrote:
To summarize:
* String based methods: helper methods for users
* EntityReference based methods: what we are supposed to use or anyone
that want to write proper code
OK, that's what I wanted to know :)
I share this vision, and would be -1 to deprecate string based APIs
(unless of course replaced with new string based helpers). I think it's
important that we keep (velocity) simple scripting accessible to
non-developers and that was my concern. You don't want to force users to
know/understand what a reference resolver is for instance.
As for what we do for velocity code in our own wiki pages (not .vms), I
would tend to think we should keep it simple to read for users (so with
string based APIs) but I'm a bit undecided. Hi,
I'd like to suggest the following strategy for now:
* We modify all our vm files to use references (by using the
ModelScriptService, see below)
* We introduce APIs taking References in api.* (ex: api.Document,
api.XWiki)
* We _don't_ deprecate existing APIs in api.*. This means we allow
users
to use the older string APIs for ease of use
Hello Vincent,
Before I can make up my mind, I would like to know:
* What will be the strategy for velocity code in wiki pages (here you
mention only .vm pages - will the strategy be voted again for wiki
pages?)
* Considering we use the same strategy for wiki pages, and since we do
not
deprecate the old APIs that manipulate strings, what will be the
'recommanded' way of say getting a document ? (the one we would
advertise
on xwiki.org code examples for example)
Jerome
--
Thomas Mortagne
>
> Thanks,
> Jerome
>
>
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs