On Thu, Feb 11, 2016 at 6:24 PM, Eduard Moraru <[email protected]> wrote: > Hi, > > On Thu, Feb 11, 2016 at 6:10 PM, [email protected] <[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 :). > >> >> * “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 >> > _______________________________________________ > 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
