30 Dec
2006
30 Dec
'06
9:02 p.m.
On 12/30/06, Vincent Massol <vincent(a)massol.net> wrote:
Yes, but if the user can't use the documentation only with core. they
need the web interface which is not (or soon will not be) in the core.
And if we want to have the documentation of the core in the core, we
should I think convert the documentation to text pages, in a readable
format. Or for example if he can't make xwiki running, he will not be
able to read the documentation to know how to do, and how to import
the documentation:-)
I don't think it's a good idea to have the users having to load the
documentation in the wiki for reading it. I would prefer to have it in
pdf or text mode if you want an offline mode. we can at every release
export xwiki.org and pack it with the binaries and source packages.
WDYT?
jeremi
Hi Jeremi,
ok
-----Original Message-----
From: jeremi23(a)gmail.com [mailto:jeremi23@gmail.com] On Behalf Of
jeremi joslin
Sent: samedi 30 décembre 2006 12:00
To: xwiki-dev(a)objectweb.org
Subject: Re: [xwiki-dev] [Proposal] Create wikis/ module in SVN
On 12/27/06, Vincent Massol <vincent(a)massol.net> wrote:
cleaned up
more.
Ok fine. I wanted to do it in 2 steps but we can do it now after all. It's possibly
even better.
> -----Original Message-----
> From: jeremi23(a)gmail.com [mailto:jeremi23@gmail.com] On Behalf Of
> jeremi joslin
> Sent: mercredi 27 décembre 2006 14:20
> To: xwiki-dev(a)objectweb.org
> Subject: Re: [xwiki-dev] [Proposal] Create wikis/ module in SVN
>
> Hi,
> it's a good idea to save xwiki.org on the svn. But i'm not sure
it's
a good
idea to put it in the same trunk as xwiki core. I would
prefer to have it somwhere else.
I would like to do it in 2 steps:
* step 1: create them in xwiki/xwiki/trunk.
* step 2: create some other place later on when we have our structure
One rationale now is to have the same release cycle for the site
(xwiki.org) as
for the code so I think it makes sense, for now at
least, to have it in the same place as the code.
It makes sens to have it sync. But someone who just want the source
code of the core of xwiki does not want xwiki.org pages.
We should try
to keep the core code as small as possible I think.
And xwiki.org is
not all about the core, it's also about plugins, applications who have
there own lifecycle.
I'm thus changing my proposal for creating a top level xwiki-documentation module
(same level as xwiki, xwiki-clients, xwiki-sandbox, xwiki-applications, etc).
that's a good idea.
I would prefer to have it somewhere else on the
repository, even if we tag it at the same time as the xwiki core.
In svn we have a unique revison number for all the repository, so it's
already sync.
What do you think?
Thanks
-Vincent
PS: I don't consider the fact that developers can checkout the core separately from
the documentation a good thing. I think it's actually bad as it doesn't help
developers thinking about documentation. In any case if the proposal is accepted I'll
add xwiki-documentation in the svn:externals of trunks-dev.