On Thu, Feb 11, 2016 at 7:24 PM, [email protected] <[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). > > 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
