From version 115.3
edited by Vincent Massol
on 2019/12/17 08:17
To version 116.1
edited by Vincent Massol
on 2020/01/06 07:49
Change comment: Mailing list --> Forum

Summary

Details

Page properties
Content
... ... @@ -17,7 +17,7 @@
17 17  * A **GitHub repository**, under http://github.com/xwiki-contrib
18 18  * A **JIRA project** for tracking bugs and feature requests, at https://jira.xwiki.org/ and under the "XWiki Contributed projects" category. Note that each project should have its own JIRA project (we used to have a single generic JIRA project with different ##components## but this was creating difficulties).
19 19  * A generic **maven groupId**: ##org.xwiki.contrib## (or ##org.xwiki.contrib.<module name>## if the project has several modules). That's until the project reaches a certain size and visibility, in which case it can have its own maven group id.
20 -* A **Mailing list** for your project. Note that for the moment, all the projects share [[common mailing lists>>dev:Community.MailingLists]].
20 +* A **Forum** for your project. Note that for the moment, all the projects share the [[Development category of the forum>>https://forum.xwiki.org/c/Dev]].
21 21  * **Project pages** on [[extensions.xwiki.org>>extensions:Main.WebHome]] to describe and document the project. When the project reaches a certain visibility and size it can have its own wiki on xwiki.org.
22 22  * A **CI job** on http://ci.xwiki.org for building the project automatically on each commit (more specifically see [[XWiki Contrib jobs>>http://ci.xwiki.org/view/Contrib/job/XWiki%20Contrib/]]).
23 23  * A **Sonar project report** on http://sonar.xwiki.org to analyze the project's quality with various metrics.
... ... @@ -25,7 +25,7 @@
25 25  
26 26  = Contributing to an existing project =
27 27  
28 -If you're interested to contribute to an existing project on http://github.com/xwiki-contrib, please send an email to **##devs AT xwiki.org##** (after having [[subscribed>>dev:Community.MailingLists]]), introducing yourself and explaining what you wish to do. Make sure to create an account on GitHub and mention this id in the email so that we can give you access. Thanks for helping out! :)
28 +If you're interested to contribute to an existing project on http://github.com/xwiki-contrib, please send a post to the [[Forum (dev category)>>https://forum.xwiki.org/c/Dev]], introducing yourself and explaining what you wish to do. Make sure to create an account on GitHub and mention this id in the email so that we can give you access. Thanks for helping out! :)
29 29  
30 30  = Why join XWiki Contrib =
31 31  
... ... @@ -37,7 +37,7 @@
37 37  
38 38  = Requesting a project =
39 39  
40 -The contrib project is open for anyone who wish to start a new project. Simply send us an email at **##devs AT xwiki.org##** using "**[Contrib]**" at the beginning of your email's subject (after having [[subscribed>>dev:Community.MailingLists]]). Let us know the name and a short description of the project. If your project has already been made available for download on extensions.xwiki.org, please mention it and point us to its page (If it is not, then no need to hurry, you will make it available once it's ready). Finally, let us know which of the tools listed above you need. For GitHub access, you will need to register a user on http://github.com and let us know about it (a best practice is to have a username composed of the first letter of your first name immediately followed by your last name, the whole with no capital letter, for example **jdoe** if your name is John Doe).
40 +The contrib project is open for anyone who wish to start a new project. Simply send a post on the [[Forum (dev category)>>https://forum.xwiki.org/c/Dev]] using the ##contrib## in your post. Let us know the name and a short description of the project. If your project has already been made available for download on extensions.xwiki.org, please mention it and point us to its page (If it is not, then no need to hurry, you will make it available once it's ready). Finally, let us know which of the tools listed above you need. For GitHub access, you will need to register a user on http://github.com and let us know about it (a best practice is to have a username composed of the first letter of your first name immediately followed by your last name, the whole with no capital letter, for example **jdoe** if your name is John Doe).
41 41  
42 42  == Choosing the name ==
43 43  
... ... @@ -82,7 +82,7 @@
82 82   * [<pretty name of pageN, e.g. My App API](<urlN on e.x.o)
83 83  </if several extension pages>
84 84  * [Issue Tracker](<url on jira.xwiki.org, e.g. https://jira.xwiki.org/browse/XAFLASHM>)
85 -* Communication: [Mailing List](<url, e.g. http://dev.xwiki.org/xwiki/bin/view/Community/MailingLists>), [IRC](<url, e.g. http://dev.xwiki.org/xwiki/bin/view/Community/IRC>)
85 +* Communication: [Forum](<url, e.g. https://forum.xwiki.org/c/Devs>), [IRC](<url, e.g. http://dev.xwiki.org/xwiki/bin/view/Community/IRC>)
86 86  <if link pointing to all dev practices>
87 87  * [Development Practices](<URL pointing to a site defining the list of practices to be followed by contributors when contributing on this project>)
88 88  </if link pointing to all dev practices>
... ... @@ -218,7 +218,7 @@
218 218  )))
219 219  
220 220  {{warning}}
221 -At the moment, we still need to trigger a rescan of the GitHub organization to make a new project appear on the [[CI page for XWiki Contrib>>http://ci.xwiki.org/view/Contrib/job/XWiki%20Contrib/]]. Please ping a dev on IRC or on the [[Developer's list>>dev:Community.MailingLists]].
221 +At the moment, we still need to trigger a rescan of the GitHub organization to make a new project appear on the [[CI page for XWiki Contrib>>http://ci.xwiki.org/view/Contrib/job/XWiki%20Contrib/]]. Please ping a dev on IRC or on the [[Forum>>https://forum.xwiki.org/c/Dev]].
222 222  {{/warning}}
223 223  
224 224  = Release the project =
... ... @@ -237,7 +237,7 @@
237 237  XWiki.org allows you to release your project on the [[XWiki Maven Remote Repository>>http://nexus.xwiki.org]] as long as you follow these steps:
238 238  
239 239  * Use ##org.xwiki.contrib## as ##groupId## in your maven module
240 -* Request for an account on [[Nexus>>http://nexus.xwiki.org]] by sending a mail to the [[Developer's list>>dev:Community.MailingLists]] mentioning the username you'd wish to have (you could also mention which extension you're planning to release to provide contextual information).
240 +* Request for an account on [[Nexus>>http://nexus.xwiki.org]] by sending a post on the [[Forum>>https://forum.xwiki.org/c/Dev]], mentioning the username you'd wish to have (you could also mention which extension you're planning to release to provide contextual information).
241 241  * Once you've received your credentials put them in(((
242 242  ##~~/.m2/settings.xml##
243 243  
... ... @@ -381,7 +381,7 @@
381 381  {{/warning}}
382 382  )))
383 383  * Note that you'll need to push the changes done by the release plugin: {{code}}git push origin master{{/code}}
384 -* By default the extension will be automatically released on ##nexus.xwiki.org##. In case you have configured your extension's POM so that it's not the case then ask for someone (on the devs mailing list or on IRC) to validate your release from the staging repository on [[Nexus>>http://nexus.xwiki.org]] to make your extension available on ##nexus.xwiki.org##. Alternatively if you've been granted the permissions you can do this yourself by understanding [[Nexus Staging>>http://books.sonatype.com/nexus-book/reference/staging-repositories.html]]. To perform promotion do the following:
384 +* By default the extension will be automatically released on ##nexus.xwiki.org##. In case you have configured your extension's POM so that it's not the case then ask for someone (on the [[Forum>>https://forum.xwiki.org/c/Dev]] or on IRC) to validate your release from the staging repository on [[Nexus>>http://nexus.xwiki.org]] to make your extension available on ##nexus.xwiki.org##. Alternatively if you've been granted the permissions you can do this yourself by understanding [[Nexus Staging>>http://books.sonatype.com/nexus-book/reference/staging-repositories.html]]. To perform promotion do the following:
385 385  ** Select the repository to validate in the Staging Repositories list
386 386  ** Click the "Close" button to close it. Wait a few seconds since it's done asynchronously.
387 387  ** Make sure to test your extension from the closed staging repo first since a released repo cannot be removed!

Get Connected