On 12/30/06, Vincent Massol <[email protected]> wrote:
Hi Jeremi,
-----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of jeremi joslin Sent: samedi 30 décembre 2006 12:00 To: [email protected] Subject: Re: [xwiki-dev] [Proposal] Create wikis/ module in SVN
On 12/27/06, Vincent Massol <[email protected]> wrote:
-----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of jeremi joslin Sent: mercredi 27 décembre 2006 14:20 To: [email protected] 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 cleaned up more.
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.
Ok fine. I wanted to do it in 2 steps but we can do it now after all. It's possibly even better. ok
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.
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