| Marc R. Hoffmann | adc97d9 | 2009-10-16 08:24:59 +0000 | [diff] [blame^] | 1 | <?xml version="1.0" encoding="ISO-8859-1" ?>
|
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
| 3 | <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
|
| 4 | <head>
|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
|
| 6 | <link rel="stylesheet" href=".resources/doc.css" charset="ISO-8859-1" type="text/css" />
|
| 7 | <title>JaCoCo - Development Conventions</title>
|
| 8 | </head>
|
| 9 | <body>
|
| 10 |
|
| 11 | <div class="breadcrumb">
|
| 12 | <a href="../index.html" class="el_session">JaCoCo</a> >
|
| 13 | <a href="index.html" class="el_group">Documentation</a> >
|
| 14 | <span class="el_source">Development Conventions</span>
|
| 15 | </div>
|
| 16 |
|
| 17 | <h1>Development Conventions</h1>
|
| 18 |
|
| 19 | <p>
|
| 20 | Efficient team work that produces high-quality software requires a common set
|
| 21 | of rules.
|
| 22 | </p>
|
| 23 |
|
| 24 | <h3>Consistent Source Tree</h3>
|
| 25 |
|
| 26 | <p>
|
| 27 | Update your sources and run the build locally before every check-in. Commit
|
| 28 | only if the build succeeds.
|
| 29 | </p>
|
| 30 |
|
| 31 | <p>
|
| 32 | Documentation is part of the product. Whenever you implement a new feature or
|
| 33 | change existing behavior make sure to update all corresponding JavaDoc as well
|
| 34 | as other documentation with the same change set. The product should always be
|
| 35 | in a consistent state.
|
| 36 | </p>
|
| 37 |
|
| 38 | <h3>Keep an Eye on License Issues</h3>
|
| 39 |
|
| 40 | <p>
|
| 41 | All code included with JaCoCo must conform to the EPL license.
|
| 42 | </p>
|
| 43 |
|
| 44 | <ul>
|
| 45 | <li>Every third party content must be enlisted in the corresponding
|
| 46 | <code>about.html</code> file along with its license.</li>
|
| 47 | <li>Every third party content included with the JaCoCo distribution must be
|
| 48 | enlisted in the <code>org.jacoco.doc/docroot/doc/license.html</code> file
|
| 49 | along with its license.</li>
|
| 50 | <li>Every source file (Java, Build Script, DTD) must have a
|
| 51 | <a href="http://www.eclipse.org/legal/copyrightandlicensenotice.php">EPL
|
| 52 | license notice</a>. The initial contributor should be listed. In case of
|
| 53 | significant changes or additions additional contributors should also
|
| 54 | be listed.
|
| 55 | </li>
|
| 56 | </ul>
|
| 57 |
|
| 58 |
|
| 59 | <div class="footer">
|
| 60 | <div class="versioninfo"><a href="@HOMEURL@">JaCoCo</a> @VERSION@</div>
|
| 61 | <a href="license.html">Copyright</a> © 2009 Mountainminds GmbH & Co. KG and Contributors
|
| 62 | </div>
|
| 63 |
|
| 64 | </body>
|
| 65 | </html> |