Re: [xwiki-devs] [Proposal] Improving how we work in xwiki-contrib

+1. On 15/03/2016 13:12, Vincent Massol wrote: > Hi all, > > This mail is about trying to improve how we work in xwiki-contrib and

supersedes the proposal I sent at http://markmail.org/message/qzc7ipiu6lazwbwr and it's a pain to maintain (I'm trying to do it but it's a pain) allowing anyone to commit on it without the lead's approval, nor allowing anyone to release new versions of that project without the lead participating to the discussion. have permissions to release it in jira nor creating a new version,

synchronization issues extensions to xwiki-contrib but there's no clear lead for a lot of those extensions since they were developed collaboratively and there's no

of lead in the xwiki github organization. In practice the person from the XWiki core devs to work on a given extension varies over time (that’s how those extensions were built). It's not possible (and not a good idea) to give a long-time leadership to a single person. developed and maintained together. It's a place that is of interest for people who want to share their sources and work collaboratively with

on them. If the intent is only to make an extension available to users of XWiki then it's enough to publish the binaries on extensions.xwiki.org (and put the souces anywhere they wish, including on the e.x.o page or on their github account if they have one). > > * XWiki Contrib is defined by the xwiki-contrib github organization > > * Anyone can request to join this community. This is the main

with the xwiki github organization where you need to be voted in to

a committer. The main rationale is that making a mistake in the core has more impact than doing this in an extension. The second rationale is that this is an experiment to see if we can have a more vibrant community as a result of being more open, without loosing too much quality. xwiki-contrib (and he/she's also added to a group on jira allowing him to create versions and releasing them.). The goal is to favor cross-pollination. In case this causes problem in the future, we can collaboratively decide to have stricter rules but it's a good experiment/principle to start as open as possible and close only if need

(the wiki principle ;)). So far, after several years of operations, there have been no incident in this way of working for xwiki-contrib that would have required restricting permissions. the recommended development practices to follow are those found on dev.xwiki.org, i.e. the same as for the xwiki github organization. This prevents the issue that someone who wants to participate to more than 1 project needs to learn several dev practices; they're all the same. Now, these practices are best practices and the intent is that committers try

follow them as much as they can, in their capacity. Other committers reviewing code should be lenient in their comments and sentences like

must do xxx" should be avoided and instead sentences like "When you have the time, it would be nice if you could...". OTOH, when a committer joins xwiki-contrib, he/she should understand that these best practices exist (and possibly spend some time reading them), and agree about following

as much as he/she can. Obviously anyone is free to discuss an existing

and propose changing it or dropping it altogether. to send a release "[Proposal]" mail with a few lines explaining the

to release on such date. If not possible for some constraint (time, neeed to release something else quickly that depends on a given extension, etc) then the release can be performed and some "[ANN]" mail sent later on to announce the release. > > * Details on best practices (how to write one's pom.xml, how to

extensions on extensions.xwiki.org, etc) are found on contrib.xwiki.org -- Jean Simard jean.simard(a)xwiki.com Research engineer at XWiki SAS http://www.xwiki.com Committer on the XWiki.org project http://www.xwiki.org _______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs