On Thu, Feb 11, 2016 at 7:55 PM, [email protected] <[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. > > 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 >> >> >> >> -- >> Thomas Mortagne >> _______________________________________________ >> devs mailing list >> [email protected] >> http://lists.xwiki.org/mailman/listinfo/devs > _______________________________________________ > devs mailing list > [email protected] > http://lists.xwiki.org/mailman/listinfo/devs -- Thomas Mortagne _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
