[xwiki-devs] [Proposal] Terminology for xwiki.org
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. * “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”… * “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”). * 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? 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
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.
* “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
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/xw... 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
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/xw... 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). 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
On Thu, Feb 11, 2016 at 6:39 PM, [email protected] <[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/xw... 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.
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
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/xw... 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 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! ;)). 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
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/xw... 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
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/xw... 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”). 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
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/xw... 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
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/xw... > 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
+1 for "Distribution" as the "what" part... a collection of components/extesions/packages, i.e. "bundle", etc. [1] While "packaging" takes care of the "how" part... a zip/exe/jar/rpm/deb/war/etc. ...but only about wrapping/preparing the "distribution" to be installed in a specific environment or in a specific way. So the "XWiki Distribtion" is "packaged" in various ways (exe/jar/war/xar/zip) so you can intall it in your environment (os/container/etc). Thanks, Eduard ---------- [1] https://en.wikipedia.org/wiki/Software_distribution On Thu, Feb 11, 2016 at 8:11 PM, Thomas Mortagne <[email protected]> wrote:
On Thu, Feb 11, 2016 at 6:39 PM, [email protected] <[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/xw...
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.
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
On 11 Feb 2016 at 18:25:26, Eduard Moraru ([email protected](mailto:[email protected])) 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?
Was thinking about this too but I’m not sure we need a wiki for that. Right now the install docs are on platform already (http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation).
Also, the runtime is the result/artefact of building the platform, right? It`s what you actually get to install, as a user.
Yes correct. I have hesitated long and hard on this when I wrote my email. I put XWiki Runtime, then put XWiki Platform instead and finally went back to XWiki Runtime since using XWiki Platform would cause confusions IMO (with several meanings). I found myself using XWiki Platform Runtime anyway in writing. So using directly XWiki Runtime seems the less ambiguous term for me.
* “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?
Yes. "XWiki Runtime is a runtime-platform onto which you can develop applications which can be bundled as Extensions.”
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.
Actually this is what I said: "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”". I can make 2 bullet points and not say they’re synonymous.
* “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”.
For me this is the XWiki Runtime. The Default Flavor is not part of the runtime. When you execute the runtime you decide which Flavor to use. You don’t have to use the Default Flavor. You can use other flavors such as the Demo flavor for example.
* 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).
Cool, thanks -Vincent
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
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto:[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(http://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(http://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.
* “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”…
* “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(http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
I forgot a very important one: What’s the scope of "XWiki Core”? For that we can update the “XWiki Core” definition: * “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib. WDYT? Thanks -Vincent
Once agreed I’ll kickstart the work by updating xwiki.org(http://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
On Fri, Feb 12, 2016 at 12:32 PM, [email protected] <[email protected]> wrote:
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto:[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(http://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(http://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.
* “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”…
* “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(http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
I forgot a very important one: What’s the scope of "XWiki Core”? For that we can update the “XWiki Core” definition:
* “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib.
Not sure about this. Out of the blue it's more or less what we want but there is use cases where a module that is not absolutely needed to have in the default flavor is still very tied to the platform version and should be released with it. One example is Repository App for which all the last changes were in sync with changes in the extension API (so more tied to commons than platform here), would be a pain to maintain this one as a contrib module.
WDYT?
Thanks -Vincent
Once agreed I’ll kickstart the work by updating xwiki.org(http://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
On Fri, Feb 12, 2016 at 12:45 PM, Thomas Mortagne <[email protected]> wrote:
On Fri, Feb 12, 2016 at 12:32 PM, [email protected] <[email protected]> wrote:
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto:[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(http://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(http://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.
* “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”…
* “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(http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
I forgot a very important one: What’s the scope of "XWiki Core”? For that we can update the “XWiki Core” definition:
* “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib.
Not sure about this. Out of the blue it's more or less what we want but there is use cases where a module that is not absolutely needed to have in the default flavor is still very tied to the platform version and should be released with it. One example is Repository App for which all the last changes were in sync with changes in the extension API (so more tied to commons than platform here), would be a pain to maintain this one as a contrib module.
I guess we could say that's the rule and in rare cases we have exceptions (like ignoring a checkstyle rule).
WDYT?
Thanks -Vincent
Once agreed I’ll kickstart the work by updating xwiki.org(http://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
-- Thomas Mortagne
Ok so we have 3 answers so far… If you agree or don’t agree please send us your inputs, since 3 answers is not that much! I’d really like to progress and publish those on xwiki.org and start using them! See below for the changes. On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto:[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(http://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(http://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.
Changed to: * The “XWiki Distribution”: the XWiki WAR that you get from the various distributions that you can find on xwiki.org(http://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. * “XWiki Packages”: the various packagings used to distribute the “XWiki Distribution”, e.g. the zip packaging, the debian packaging, the exe installer, etc.
* “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.
Changed to: * “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib (except for modules that are used to build “XWiki Core” and potentially some case by case exceptions). The rest remains unchanged. Thanks -Vincent
* “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”…
* “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(http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
Once agreed I’ll kickstart the work by updating xwiki.org(http://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
I think they are ok, although I find it to be a lot of terminology. Still not sure why we need the "XWiki N.P". First of all is a mix of NS/ND, plus I am not sure why we should give it such an importance that it enters the terminology. I would use "since 7.4.1" instead, just like we have with all our documentation done for a particular version. Also “XWiki Platform”: synonymous for “XWiki Core” I find it to be confusing and I think we should use Core instead if we want to talk about everything. Also we are keep talking about "Default Flavor" which currently now is "XWiki Enterprise" but it will change. Still the logo will be XWiki, so will we want to brand somehow the "Default Flavor"? or we just keep it XWiki? For the users "Default Flavor" = "XWiki", but I guess we will need to discuss this when the Flavors will evolve. Thanks, Caty On Tue, Feb 16, 2016 at 11:25 AM, [email protected] <[email protected]> wrote:
Ok so we have 3 answers so far… If you agree or don’t agree please send us your inputs, since 3 answers is not that much!
I’d really like to progress and publish those on xwiki.org and start using them!
See below for the changes.
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto: [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(http://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(http://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.
Changed to:
* The “XWiki Distribution”: the XWiki WAR that you get from the various distributions that you can find on xwiki.org(http://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.
* “XWiki Packages”: the various packagings used to distribute the “XWiki Distribution”, e.g. the zip packaging, the debian packaging, the exe installer, etc.
* “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.
Changed to:
* “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib (except for modules that are used to build “XWiki Core” and potentially some case by case exceptions).
The rest remains unchanged.
Thanks -Vincent
* “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”…
* “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( http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
Once agreed I’ll kickstart the work by updating xwiki.org( http://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
On 16 Feb 2016 at 11:47:12, Ecaterina Moraru (Valica) ([email protected](mailto:[email protected])) wrote:
I think they are ok, although I find it to be a lot of terminology.
Still not sure why we need the "XWiki N.P". First of all is a mix of NS/ND,
I don’t see the relationship with Nested Spaces, Nested Documents :)
plus I am not sure why we should give it such an importance that it enters the terminology. I would use "since 7.4.1" instead, just like we have with all our documentation done for a particular version.
In all/most our doc we use "since XWiki 7.4.1". We need to mention what we’re referring to or there can be ambiguity :)
Also “XWiki Platform”: synonymous for “XWiki Core” I find it to be confusing and I think we should use Core instead if we want to talk about everything.
Ah yes this is just a leftover. I forgot to remove it. Thanks.
Also we are keep talking about "Default Flavor" which currently now is "XWiki Enterprise" but it will change. Still the logo will be XWiki, so will we want to brand somehow the "Default Flavor"? or we just keep it XWiki? For the users "Default Flavor" = "XWiki", but I guess we will need to discuss this when the Flavors will evolve.
Yes indeed, we’ll discuss it then. IMO it’s the same XWiki logo. Other flavors could use different logos though. Thanks -Vincent
Thanks, Caty
On Tue, Feb 16, 2016 at 11:25 AM, [email protected] wrote:
Ok so we have 3 answers so far… If you agree or don’t agree please send us your inputs, since 3 answers is not that much!
I’d really like to progress and publish those on xwiki.org and start using them!
See below for the changes.
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected](mailto: [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(http://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(http://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.
Changed to:
* The “XWiki Distribution”: the XWiki WAR that you get from the various distributions that you can find on xwiki.org(http://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.
* “XWiki Packages”: the various packagings used to distribute the “XWiki Distribution”, e.g. the zip packaging, the debian packaging, the exe installer, etc.
* “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.
Changed to:
* “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib (except for modules that are used to build “XWiki Core” and potentially some case by case exceptions).
The rest remains unchanged.
Thanks -Vincent
* “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”…
* “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( http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
Once agreed I’ll kickstart the work by updating xwiki.org( http://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
On Tue, Feb 16, 2016 at 1:07 PM, [email protected] <[email protected]> wrote:
On 16 Feb 2016 at 11:47:12, Ecaterina Moraru (Valica) ([email protected] (mailto:[email protected])) wrote:
I think they are ok, although I find it to be a lot of terminology.
Still not sure why we need the "XWiki N.P". First of all is a mix of NS/ND,
I don’t see the relationship with Nested Spaces, Nested Documents :)
So for you XWiki N.P = XWiki x.y.z (since you gave XWiki 7.4.1 as example). I understood XWiki N.P = XWiki NS/ND and since 7.4.1 :) has Nested pages that's why I was confused. Now it's clear. Thanks, Caty
plus I am not sure why we should give it such an importance that it enters the terminology. I would use "since 7.4.1" instead, just like we have with all our documentation done for a particular version.
In all/most our doc we use "since XWiki 7.4.1". We need to mention what we’re referring to or there can be ambiguity :)
Also “XWiki Platform”: synonymous for “XWiki Core” I find it to be confusing and I think we should use Core instead if we want to talk about everything.
Ah yes this is just a leftover. I forgot to remove it. Thanks.
Also we are keep talking about "Default Flavor" which currently now is "XWiki Enterprise" but it will change. Still the logo will be XWiki, so will we want to brand somehow the "Default Flavor"? or we just keep it XWiki? For the users "Default Flavor" = "XWiki", but I guess we will need to discuss this when the Flavors will evolve.
Yes indeed, we’ll discuss it then. IMO it’s the same XWiki logo. Other flavors could use different logos though.
Thanks -Vincent
Thanks, Caty
On Tue, Feb 16, 2016 at 11:25 AM, [email protected] wrote:
Ok so we have 3 answers so far… If you agree or don’t agree please send us your inputs, since 3 answers is not that much!
I’d really like to progress and publish those on xwiki.org and start using them!
See below for the changes.
On 11 Feb 2016 at 17:10:28, [email protected] ([email protected] (mailto: [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(http://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(http://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.
Changed to:
* The “XWiki Distribution”: the XWiki WAR that you get from the various distributions that you can find on xwiki.org(http://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.
* “XWiki Packages”: the various packagings used to distribute the “XWiki Distribution”, e.g. the zip packaging, the debian packaging, the exe installer, etc.
* “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.
Changed to:
* “XWiki Core”: Represents the set of XWiki APIs/sources that end up being in the “Default Flavor". 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. Generally speaking any module that isn’t bundled in the “Default Flavor” should be moved to XWiki Contrib (except for modules that are used to build “XWiki Core” and potentially some case by case exceptions).
The rest remains unchanged.
Thanks -Vincent
* “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”…
* “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( http://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(http://enterprise.xwiki.org) will be removed and folded into platform.xwiki.org(http://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”).
* 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?
Once agreed I’ll kickstart the work by updating xwiki.org( http://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
devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
participants (4)
-
Ecaterina Moraru (Valica) -
Eduard Moraru -
Thomas Mortagne -
vincent＠massol.net