syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1412199 - in /incubator/syncope/trunk: ./ src/site/site.xml src/site/xdoc/contributing.xml
Date Wed, 21 Nov 2012 17:17:48 GMT
Author: ilgrosso
Date: Wed Nov 21 17:17:48 2012
New Revision: 1412199

Merge from 1_0_X

    incubator/syncope/trunk/src/site/xdoc/contributing.xml   (with props)
    incubator/syncope/trunk/   (props changed)

Propchange: incubator/syncope/trunk/
  Merged /incubator/syncope/branches/1_0_X:r1411316-1412198

Modified: incubator/syncope/trunk/src/site/site.xml
--- incubator/syncope/trunk/src/site/site.xml (original)
+++ incubator/syncope/trunk/src/site/site.xml Wed Nov 21 17:17:48 2012
@@ -42,7 +42,13 @@ under the License.
+  <custom>
+    <fluidoSkin>
+      <leftColumnClass>span2</leftColumnClass>
+      <bodyColumnClass>span10</bodyColumnClass>
+    </fluidoSkin>
+  </custom>
       <item name="Apache" href=""/>
@@ -73,6 +79,7 @@ under the License.
       <item name="Source Repository" href="source-repository.html"/>
       <item name="Continuous Integration" href="integration.html"/>
       <item name="Issue Tracking" href="issue-tracking.html"/>
+      <item name="How to contribute?" href="contributing.html"/>
       <item name="Release Process" href="release-process.html"/>

Added: incubator/syncope/trunk/src/site/xdoc/contributing.xml
--- incubator/syncope/trunk/src/site/xdoc/contributing.xml (added)
+++ incubator/syncope/trunk/src/site/xdoc/contributing.xml Wed Nov 21 17:17:48 2012
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="UTF-8"?>
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+<document xmlns="" xmlns:xsi=""
+          xsi:schemaLocation="">
+  <properties>
+    <title>How to contribute?</title>
+    <author email="">Apache Syncope Documentation Team</author>
+  </properties>
+  <body>
+    <section name="How to contribute?">
+      <p>
+        The Apache Syncope™ project is actively seeking new contributors to work on
all aspects of the project. 
+        We need and appreciate all contributions, including documentation help, source code
development and feedback.
+      </p>
+      <subsection name="Code">
+        <ul>
+          <li>When you have found an issue or you want to propose a new feature, post
a message to Syncope User's list to 
+            discuss it.
+          </li>
+          <li>Search existing 
+            <a href="" rel="nofollow">issues</a>
to see whether 
+            someone had already encountered the same issue.
+          </li>
+          <li>If this issue is never encountered before, create a 
+            <a href="">JIRA</a> issue.
+          </li>
+          <li>Develop a test case to demonstrate the issue.</li>
+          <li>Attach the new test to JIRA issue.</li>
+          <li>If you have also developed a fix for the raised issue, attach a patch
to it. Here are some useful 
+            <a href="">guidelines</a>
about how to correctly generate a patch.
+          </li>
+        </ul>
+      </subsection>
+      <subsection name="Documentation">
+        <p>The website is managed via the 
+          <a href="">maven-site-plugin</a>,
hence contributing site 
+          content is very close to contributing source code: create a new issue on JIRA and
attach there a SVN patch.
+        </p>
+        <p>The project 
+          <a href="">wiki</a>
is also there to gather any other kind of
+          documentation or contribution you would like to contribute, and does not require
any SVN, Maven or other 
+          technical skills.
+        </p>
+      </subsection>
+      <subsection name="Quick references">
+        <ul>
+          <li>
+            Discussion occurs on the 
+            <a href="mail-lists.html">mailing lists</a>
+          </li>
+          <li>
+            Information on access to the project source code is 
+            <a href="source-repository.html">available</a>.
+          </li>
+          <li>
+            Bugs and other issues can be posted on 
+            <a href="">JIRA</a>
+          </li>
+        </ul>
+      </subsection>
+    </section>
+    <section name="How do I become a contributor or a committer?">
+      <p>Everyone can contribute to Syncope as a contributor; contributors who build
up a history of successful 
+        contributions over time are invited to become committers. The difference is that
committers have direct write 
+        access to the project SVN repositories, while contributors post their contributions
to JIRA issues where they're
+        first reviewed, and then committed by a committer to the project's SVN repository.
+        <a href=""></a>
for a good
+        overview of working as a contributor.
+      </p>
+      <p>We ask contributors of significant amounts of code to fill out and send into
Apache, an 
+        <a href="">Individual Contributors License
Agreement (ICLA)</a> 
+        (and perhaps also a 
+        <a href="">Corporate Contributors License
Agreement (CCLA)</a>).
+      </p>
+      <p>If you're interested in committing to the project, you need to establish a
history over time of successful 
+        contributions to the project. After that, you can be invited to become a committer.
+      </p>
+      <ul>
+        <li>
+          You'll need to fill out some legal paperwork and go through a process to get an
apache committer account: See 
+          <a rel="nofollow" href="">
New Committers Guide</a>, 
+          <a rel="nofollow" href=""> Contributors</a>,
+          <a rel="nofollow" href=""> Committers</a>
for more details.
+        </li>
+        <li>
+          After you've received an email from 
+          <a href=""></a> with your committer
account information, change your 
+          initial password at 
+          <a href="">Apache Account Utility</a>. For more
details see 
+          <a rel="nofollow" href="">Committer
Subversion Access</a>.
+        </li>
+        <li>
+          Check out the Syncope sources and test your svn account: 
+          <a href="">Subversion Repository</a>.
+        </li>
+      </ul>
+      <p>All Contributors and Committers should</p>
+      <ul>
+        <li>Sign up for a 
+          <a rel="nofollow" href="">WiKi</a>
+        </li>
+        <li>Sign up for an 
+          <a rel="nofollow" href="">ASF JIRA</a>
+        </li>
+      </ul>
+    </section>
+  </body>

Propchange: incubator/syncope/trunk/src/site/xdoc/contributing.xml
    svn:eol-style = native

Propchange: incubator/syncope/trunk/src/site/xdoc/contributing.xml
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/syncope/trunk/src/site/xdoc/contributing.xml
    svn:mime-type = text/xml

View raw message