diff options
Diffstat (limited to 'docs/DeveloperPolicy.html')
| -rw-r--r-- | docs/DeveloperPolicy.html | 81 |
1 files changed, 40 insertions, 41 deletions
diff --git a/docs/DeveloperPolicy.html b/docs/DeveloperPolicy.html index ef99ebc..c121657 100644 --- a/docs/DeveloperPolicy.html +++ b/docs/DeveloperPolicy.html @@ -8,7 +8,7 @@ </head> <body> -<div class="doc_title">LLVM Developer Policy</div> +<h1>LLVM Developer Policy</h1> <ol> <li><a href="#introduction">Introduction</a></li> <li><a href="#policies">Developer Policies</a> @@ -34,9 +34,9 @@ <div class="doc_author">Written by the LLVM Oversight Team</div> <!--=========================================================================--> -<div class="doc_section"><a name="introduction">Introduction</a></div> +<h2><a name="introduction">Introduction</a></h2> <!--=========================================================================--> -<div class="doc_text"> +<div> <p>This document contains the LLVM Developer Policy which defines the project's policy towards developers and their contributions. The intent of this policy is to eliminate miscommunication, rework, and confusion that might arise from @@ -63,20 +63,19 @@ </div> <!--=========================================================================--> -<div class="doc_section"><a name="policies">Developer Policies</a></div> +<h2><a name="policies">Developer Policies</a></h2> <!--=========================================================================--> -<div class="doc_text"> +<div> <p>This section contains policies that pertain to frequent LLVM developers. We always welcome <a href="#patches">one-off patches</a> from people who do not routinely contribute to LLVM, but we expect more from frequent contributors to keep the system as efficient as possible for everyone. Frequent LLVM contributors are expected to meet the following requirements in order for LLVM to maintain a high standard of quality.<p> -</div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="informed">Stay Informed</a> </div> -<div class="doc_text"> +<h3><a name="informed">Stay Informed</a></h3> +<div> <p>Developers should stay informed by reading at least the "dev" mailing list for the projects you are interested in, such as <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">llvmdev</a> for @@ -102,9 +101,9 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="patches">Making a Patch</a></div> +<h3><a name="patches">Making a Patch</a></h3> -<div class="doc_text"> +<div> <p>When making a patch for review, the goal is to make it as easy for the reviewer to read it as possible. As such, we recommend that you:</p> @@ -142,8 +141,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="reviews">Code Reviews</a></div> -<div class="doc_text"> +<h3><a name="reviews">Code Reviews</a></h3> +<div> <p>LLVM has a code review policy. Code review is one way to increase the quality of software. We generally follow these policies:</p> @@ -174,8 +173,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="owners">Code Owners</a></div> -<div class="doc_text"> +<h3><a name="owners">Code Owners</a></h3> +<div> <p>The LLVM Project relies on two features of its process to maintain rapid development in addition to the high quality of its source base: the @@ -225,8 +224,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="testcases">Test Cases</a></div> -<div class="doc_text"> +<h3><a name="testcases">Test Cases</a></h3> +<div> <p>Developers are required to create test cases for any bugs fixed and any new features added. Some tips for getting your testcase approved:</p> @@ -258,8 +257,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="quality">Quality</a></div> -<div class="doc_text"> +<h3><a name="quality">Quality</a></h3> +<div> <p>The minimum quality standards that any change must satisfy before being committed to the main development branch are:</p> @@ -318,9 +317,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> - <a name="commitaccess">Obtaining Commit Access</a></div> -<div class="doc_text"> +<h3><a name="commitaccess">Obtaining Commit Access</a></h3> +<div> <p>We grant commit access to contributors with a track record of submitting high quality patches. If you would like commit access, please send an email to @@ -381,8 +379,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="newwork">Making a Major Change</a></div> -<div class="doc_text"> +<h3><a name="newwork">Making a Major Change</a></h3> +<div> <p>When a developer begins a major new project with the aim of contributing it back to LLVM, s/he should inform the community with an email to the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">llvmdev</a> @@ -410,9 +408,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"> <a name="incremental">Incremental Development</a> -</div> -<div class="doc_text"> +<h3><a name="incremental">Incremental Development</a></h3> +<div> <p>In the LLVM project, we do all significant changes as a series of incremental patches. We have a strong dislike for huge changes or long-term development branches. Long-term development branches have a number of drawbacks:</p> @@ -472,9 +469,8 @@ </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"><a name="attribution">Attribution of -Changes</a></div> -<div class="doc_text"> +<h3><a name="attribution">Attribution of Changes</a></h3> +<div> <p>We believe in correct attribution of contributions to their contributors. However, we do not want the source code to be littered with random attributions "this code written by J. Random Hacker" (this is noisy and @@ -486,13 +482,15 @@ Changes</a></div> <p>Overall, please do not add contributor names to the source code.</p> </div> +</div> + <!--=========================================================================--> -<div class="doc_section"> +<h2> <a name="clp">Copyright, License, and Patents</a> -</div> +</h2> <!--=========================================================================--> -<div class="doc_text"> +<div> <p>This section addresses the issues of copyright, license and patents for the LLVM project. Currently, the University of Illinois is the LLVM copyright holder and the terms of its license to LLVM users and developers is the @@ -504,11 +502,10 @@ Changes</a></div> legal matters but does not provide legal advice. We are not lawyers, please seek legal counsel from an attorney.</p> </div> -</div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"><a name="copyright">Copyright</a></div> -<div class="doc_text"> +<h3><a name="copyright">Copyright</a></h3> +<div> <p>The LLVM project does not require copyright assignments, which means that the copyright for the code in the project is held by its respective contributors @@ -530,8 +527,8 @@ Changes</a></div> </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"><a name="license">License</a></div> -<div class="doc_text"> +<h3><a name="license">License</a></h3> +<div> <p>We intend to keep LLVM perpetually open source and to use a liberal open source license. All of the code in LLVM is available under the <a href="http://www.opensource.org/licenses/UoI-NCSA.php">University of @@ -585,8 +582,8 @@ Changes</a></div> </div> <!-- _______________________________________________________________________ --> -<div class="doc_subsection"><a name="patents">Patents</a></div> -<div class="doc_text"> +<h3><a name="patents">Patents</a></h3> +<div> <p>To the best of our knowledge, LLVM does not infringe on any patents (we have actually removed code from LLVM in the past that was found to infringe). Having code in LLVM that infringes on patents would violate an important goal @@ -602,6 +599,8 @@ Changes</a></div> details.</p> </div> +</div> + <!-- *********************************************************************** --> <hr> <address> @@ -611,8 +610,8 @@ Changes</a></div> src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a> Written by the <a href="mailto:llvm-oversight@cs.uiuc.edu">LLVM Oversight Group</a><br> - <a href="http://llvm.org">The LLVM Compiler Infrastructure</a><br> - Last modified: $Date: 2010-11-16 22:32:53 +0100 (Tue, 16 Nov 2010) $ + <a href="http://llvm.org/">The LLVM Compiler Infrastructure</a><br> + Last modified: $Date: 2011-04-23 02:30:22 +0200 (Sat, 23 Apr 2011) $ </address> </body> </html> |
