syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ilgro...@apache.org
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

URL: http://svn.apache.org/viewvc?rev=1412199&view=rev
Log:
Merge from 1_0_X

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

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

Modified: incubator/syncope/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/incubator/syncope/trunk/src/site/site.xml?rev=1412199&r1=1412198&r2=1412199&view=diff
==============================================================================
--- 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.
     <artifactId>maven-fluido-skin</artifactId>
     <version>1.3.0</version>
   </skin>
-
+  <custom>
+    <fluidoSkin>
+      <leftColumnClass>span2</leftColumnClass>
+      <bodyColumnClass>span10</bodyColumnClass>
+    </fluidoSkin>
+  </custom>
+  
   <body>
     <links>
       <item name="Apache" href="http://www.apache.org/"/>
@@ -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"/>
     </menu>
 

Added: incubator/syncope/trunk/src/site/xdoc/contributing.xml
URL: http://svn.apache.org/viewvc/incubator/syncope/trunk/src/site/xdoc/contributing.xml?rev=1412199&view=auto
==============================================================================
--- 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
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+
+-->
+<document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+
+  <properties>
+    <title>How to contribute?</title>
+    <author email="syncope-dev@incubator.apache.org">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="https://issues.apache.org/jira/secure/IssueNavigator.jspa" 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="http://issues.apache.org/jira/browse/SYNCOPE">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="https://commons.apache.org/patches.html">guidelines</a>
about how to correctly generate a patch.
+          </li>
+        </ul>
+      </subsection>
+
+      <subsection name="Documentation">
+        <p>The website is managed via the 
+          <a href="http://maven.apache.org/plugins/maven-site-plugin/">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="http://cwiki.apache.org/confluence/display/SYNCOPE">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="https://issues.apache.org/jira/browse/SYNCOPE">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.
See 
+        <a href="http://www.apache.org/dev/contributors.html">http://www.apache.org/dev/contributors.html</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="http://www.apache.org/licenses/#clas">Individual Contributors License
Agreement (ICLA)</a> 
+        (and perhaps also a 
+        <a href="http://www.apache.org/licenses/#clas">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="http://apache.org/dev/new-committers-guide.html">
New Committers Guide</a>, 
+          <a rel="nofollow" href="http://apache.org/dev/contributors.html"> Contributors</a>,
and 
+          <a rel="nofollow" href="http://apache.org/dev/committers.html"> Committers</a>
for more details.
+        </li>
+        <li>
+          After you've received an email from 
+          <a href="mailto:root@apache.org">root@apache.org</a> with your committer
account information, change your 
+          initial password at 
+          <a href="https://id.apache.org">Apache Account Utility</a>. For more
details see 
+          <a rel="nofollow" href="http://apache.org/dev/version-control.html">Committer
Subversion Access</a>.
+        </li>
+        <li>
+          Check out the Syncope sources and test your svn account: 
+          <a href="http://svn.apache.org/viewvc/incubator/syncope/">Subversion Repository</a>.
+        </li>
+      </ul>
+      <p>All Contributors and Committers should</p>
+      <ul>
+        <li>Sign up for a 
+          <a rel="nofollow" href="https://cwiki.apache.org/confluence/signup.action">WiKi</a>
account.
+        </li>
+        <li>Sign up for an 
+          <a rel="nofollow" href="http://issues.apache.org/jira/">ASF JIRA</a>
account.
+        </li>
+      </ul>
+    </section>
+  </body>
+</document>

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



Mime
View raw message