Re: [xwiki-devs] [Proposal] Terminology for xwiki.org

On Thu, Feb 11, 2016 at 6:24 PM, Eduard Moraru wrote: 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/x… 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