On 12 Feb 2016 at 08:58:55, Thomas Mortagne
([email protected](mailto:[email protected])) wrote:
> On Thu, Feb 11, 2016 at 7:55 PM, [email protected] wrote:
> >
> >
> >
> >
> >
> > On 11 Feb 2016 at 19:47:33, Thomas Mortagne
> > ([email protected](mailto:[email protected])) wrote:
> >
> >> On Thu, Feb 11, 2016 at 7:24 PM, [email protected] wrote:
> >> >
> >> >
> >> >
> >> > On 11 Feb 2016 at 19:11:43, Thomas Mortagne
> >> > ([email protected](mailto:[email protected])) wrote:
> >> >
> >> >> On Thu, Feb 11, 2016 at 6:39 PM, [email protected] wrote:
> >> >> >
> >> >> > On 11 Feb 2016 at 18:33:57, Thomas Mortagne
> >> >> > ([email protected](mailto:[email protected])) wrote:
> >> >> >
> >> >> >> On Thu, Feb 11, 2016 at 6:24 PM, Eduard Moraru wrote:
> >> >> >> > Hi,
> >> >> >> >
> >> >> >> > On Thu, Feb 11, 2016 at 6:10 PM, [email protected]
> >> >> >> > wrote:
> >> >> >> >
> >> >> >> >> Hi devs,
> >> >> >> >>
> >> >> >> >> Now that we’ve voted on the "XWiki Core” concept and that we’ve
> >> >> >> >> agreed
> >> >> >> >> that the xwiki organization on github should focused on offering
> >> >> >> >> core
> >> >> >> >> extensions only (and the rest should be moved to contrib) we need
> >> >> >> >> to ensure
> >> >> >> >> that we use the same terminology everywhere.
> >> >> >> >>
> >> >> >> >> I’d like to start updating xwiki.org accordingly but first I want
> >> >> >> >> to be
> >> >> >> >> sure we agree on the terminology:
> >> >> >> >>
> >> >> >> >> * The "XWiki Runtime”: the XWiki WAR that you get from the various
> >> >> >> >> distributions that you can find on xwiki.org. It’s a minimalistic
> >> >> >> >> runtime
> >> >> >> >> on top of which you can install Extensions. Documentation for it
> >> >> >> >> will be
> >> >> >> >> available at http://platform.xwiki.org.
> >> >> >> >>
> >> >> >> >
> >> >> >> > The doc for "XWiki Runtime" is available on platform.xwiki.org
> >> >> >> > (not on
> >> >> >> > runtime.xwiki.org).... sounds a bit weird to me. Maybe we should
> >> >> >> > create an
> >> >> >> > alias for runtime, just in case?
> >> >> >> >
> >> >> >> > Also, the runtime is the result/artefact of building the platform,
> >> >> >> > right?
> >> >> >> > It`s what you actually get to install, as a user.
> >> >> >> >
> >> >> >>
> >> >> >> I think I would prefer "XWiki Distribution" since that's what it is
> >> >> >> after all: some distribution of XWiki and the only one we support.
> >> >> >> That's also the naming I started to use on
> >> >> >> https://github.com/xwiki/xwiki-platform/tree/feature-platformdistribution/xwiki-platform-distribution
> >> >> >> and I don't want to rename all that :).
> >> >> >
> >> >> > For me, the XWiki distributions is a different concept. There are
> >> >> > various distributions: WAR, ZIP, debian, EXE, etc.
> >> >> >
> >> >> > The XWiki Runtime is always included in the various distribution.
> >> >> > However the distributions can include other files (for example HSQLDB
> >> >> > and Jetty for the ZIP distribution).
> >> >> >
> >> >> > A distribution, as the name implies, is how you distribute something.
> >> >> > It doesn’t represent the runtime (which is included in the various
> >> >> > distributions, along with other things).
> >> >> >
> >> >>
> >> >> For me "distribution" has the same meaning than in Linux world: a
> >> >> arbitrary choice of stuff put together to make a produce you can use.
> >> >> It's also the meaning it has in the Distribution Wizard which is to
> >> >> setup the distribution you installed. WAR, ZIP, DEB, etc. are just
> >> >> packages of this distribution.
> >> >
> >> > So we have 2 options:
> >> >
> >> > * Option A:
> >> > ** The "XWiki Runtime"
> >> > ** "XWiki Distributions": the way the XWiki Runtime is distributed: zip
> >> > distribution, debian distribution, exe distribution, etc
> >> > ** XWiki 7.4.1 <==> XWiki Runtime 7.4.1
> >> >
> >> > * Option B:
> >> > ** The "XWiki Distribution”
> >> > ** "XWiki Packagings": the zip packaging, the debian packaging, the exe
> >> > packaging, etc
> >>
> >> "XWiki Distribution Packages" sounds better to me but it's a detail.
> >>
> >> > ** XWiki 7.4.1 <==> XWiki Distribution 7.4.1
> >> >
> >>
> >> > It’s probably because I’m not in the linux world but option A seems less
> >> > ambiguous to me. I hope that in option B when you say to someone
> >> > “download the xwiki distribution” that it’s understandable that it means
> >> > they choose the packaging they want and that they do not answer “which
> >> > distribution?” (since there’s only one, they shouldn’t ask this! ;)).
> >>
> >> We only support one is not the same as there is only one. Anyone can
> >> create other distributions of XWiki (based on this one most probably).
> >
> > Note that can only be a single XWiki Runtime (or XWiki Distribution).
> >
> > If others want to create other runtimes (or other distributions) then they
> > cannot name it just “XWiki Distribution” (that’s a reserved keyword from
> > the XWiki open source project).
> >
> > For example they’d say “XCS Runtime” (or “XCS distribution”). But they
> > cannot say “XWiki Distribution”. So there cannot be any ambiguity when you
> > say the “XWiki Runtime” (or “XWiki Distribution”).
>
> I said "other distributions" nit other "XWiki Distribution" :) This
> one is the default distribution basically.
You commented on my mail saying the following:
"We only support one is not the same as there is only one. Anyone can create
other distributions of XWiki (based on this one most probably).”
The only reason to comment like this is because you thought that I said that
there was only 1 distribution. But I didn’t say that.
I said if 'you you say to someone “download the xwiki distribution” then they
shouldn’t 'answer “which distribution?”’ because 'there’s only one’.
I never said that there can be only one distribution. I said there can only be
one “XWiki Distribution”. It would be THE XWiki Distribution.
Let’s see what others prefer between option A and B.
Thanks
-Vincent
> > Thanks
> > -Vincent
> >
> >> > I’ll go with whatever the majority chooses.
> >> >
> >> > Thanks
> >> > -Vincent
> >> >
> >> >> > Thanks
> >> >> > -Vincent
> >> >> >
> >> >> >> >> * “XWiki Core”: Represents the set of XWiki APIs/sources making
> >> >> >> >> up the
> >> >> >> >> "XWiki Platform”.
> >> >> >> >>
> >> >> >> > The sources are available in github in the xwiki-commons,
> >> >> >> > xwiki-rendering
> >> >> >> >> and xwiki-platform repositories. More globally can be meant to
> >> >> >> >> represent
> >> >> >> >> all the sources found in the xwiki github organization.
> >> >> >> >>
> >> >> >> >> * “XWiki Contrib”: Extensions to the "XWiki Runtime”. Located
> >> >> >> >> under the
> >> >> >> >> xwiki-contrib organization in github.
> >> >> >> >>
> >> >> >> >> * The "XWiki Core Development Team” or “XWiki Core Team”
> >> >> >> >> (previously
> >> >> >> >> called "XWiki Development Team"): the list of committers of the
> >> >> >> >> “xwiki"
> >> >> >> >> github organization.
> >> >> >> >>
> >> >> >> >> * “XWiki Platform”: synonymous for “XWiki Core”. Since “XWiki
> >> >> >> >> Platform”
> >> >> >> >> could also represent the xwiki-platform github repository, it’s
> >> >> >> >> better to
> >> >> >> >> use “XWiki Core” when wanting to name the full content of the
> >> >> >> >> xwiki github
> >> >> >> >> organization. For example: “The XWiki Core Development Team works
> >> >> >> >> on XWiki
> >> >> >> >> Core”…
> >> >> >> >>
> >> >> >> >
> >> >> >> > But we will still be saying that XWiki is a "platform" on which
> >> >> >> > you can
> >> >> >> > build your stuff, right?
> >> >> >> >
> >> >> >> > I would prefer not to mix the 2 terms, "Platform" and "Core",
> >> >> >> > since IMO
> >> >> >> > "Core" includes "Platform", but not necessarily the other way
> >> >> >> > around.
> >> >> >> > Remember that commons and rendering are theoretically stand-alone
> >> >> >> > projects
> >> >> >> > which are not directly connected to XWiki. The Platform works with
> >> >> >> > the
> >> >> >> > rendering and commons to produce its artefacts but I would no go
> >> >> >> > as far as
> >> >> >> > to say that it also includes them and would prefer to use "XWiki
> >> >> >> > Core" for
> >> >> >> > that part.
> >> >> >> >
> >> >> >> >
> >> >> >> >>
> >> >> >> >> * “Flavor”: a set of Extensions (usually with a purpose) that can
> >> >> >> >> be
> >> >> >> >> installed all together in a XWiki Runtime or when creating a
> >> >> >> >> subwiki inside
> >> >> >> >> the XWiki Runtime.
> >> >> >> >>
> >> >> >> >> * The “Default Flavor”: the unique flavor provided by the “XWiki
> >> >> >> >> Core
> >> >> >> >> Development Team”. Contrib projects and more generally anyone
> >> >> >> >> else can
> >> >> >> >> contribute other flavors on extensions.xwiki.org. These flavors
> >> >> >> >> will
> >> >> >> >> appear in the XWiki Platform when you first run it or when you
> >> >> >> >> create a new
> >> >> >> >> subwiki. The Default Flavor is going to replace “XWiki
> >> >> >> >> Enterprise” (and
> >> >> >> >> enterprise.xwiki.org will be removed and folded into
> >> >> >> >> platform.xwiki.org -
> >> >> >> >> the same will happen for xwiki-enterprise which will be folded
> >> >> >> >> into
> >> >> >> >> xwiki-platform in github)
> >> >> >> >>
> >> >> >> >> * “XWiki Committers” or “XWiki Team". Vague terms that represent
> >> >> >> >> the full
> >> >> >> >> set of committers of both the xwiki and xwiki-contrib github
> >> >> >> >> organizations.
> >> >> >> >>
> >> >> >> >> * “XWiki N.P”. Shortcut for the “XWiki Runtime” version N.P (e.g.
> >> >> >> >> “XWiki
> >> >> >> >> 7.4.1”).
> >> >> >> >>
> >> >> >> >
> >> >> >> > Will probably also be synonymous with "Default Flavor" version N.P
> >> >> >> > since it
> >> >> >> > will be synchronized with the "XWiki Runtime".
> >> >> >> >
> >> >> >> >
> >> >> >> >>
> >> >> >> >> * The “XWiki Project”. Generic term that includes the work done
> >> >> >> >> by XWiki
> >> >> >> >> Contrib Committers, XWiki Core Committers and by extensions the
> >> >> >> >> work done
> >> >> >> >> by the full community of contributors to both xwiki and
> >> >> >> >> xwiki-contrib
> >> >> >> >> github organizations.
> >> >> >> >>
> >> >> >> >>
> >> >> >> >> Do you agree with this? Any other terms that we should define?
> >> >> >> >>
> >> >> >> >
> >> >> >> > Generally +1 (with the above mentions).
> >> >> >> >
> >> >> >> > Thanks,
> >> >> >> > Eduard
> >> >> >> >
> >> >> >> >
> >> >> >> >>
> >> >> >> >> Once agreed I’ll kickstart the work by updating xwiki.org pages by
> >> >> >> >> creating a Terminology page and update some existing pages.
> >> >> >> >> However it’ll
> >> >> >> >> be up to everyone to follow the terminology.
> >> >> >> >>
> >> >> >> >> Thanks
> >> >> >> >> -Vincent
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
