| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 1 | illumos gate README - Sep 16, 2012. |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 2 | |
| Garrett D'Amore | 2ad7205 | 2010-09-13 15:21:36 -0700 | [diff] [blame] | 3 | This is the illumos gate. This is the illumos source tree. It contains |
| 4 | the following subdirectories: |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 5 | |
| Garrett D'Amore | 2ad7205 | 2010-09-13 15:21:36 -0700 | [diff] [blame] | 6 | usr/src - The actual source code |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 7 | |
| Garrett D'Amore | 2ad7205 | 2010-09-13 15:21:36 -0700 | [diff] [blame] | 8 | exception_lists - These are lists of exceptional cases |
| 9 | used to limit noise during builds. |
| 10 | Ideally this directory would consist of |
| 11 | only empty files. |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 12 | |
| 13 | Integration Rules: |
| 14 | |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 15 | All changes must have been reviewed, and approved by an advocate |
| Garrett D'Amore | 2ad7205 | 2010-09-13 15:21:36 -0700 | [diff] [blame] | 16 | (below). A code review may be performed by someone other than the |
| 17 | advocate, but the final integration should still be approved by the |
| 18 | advocate. |
| 19 | |
| 20 | The advocate will want to see your webrev and hg outgoing -v. The |
| 21 | advocate will also ask about your testing, and may ask to see your |
| 22 | build logs. |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 23 | |
| 24 | All changes must adhere to typical ON style and quality rules. |
| 25 | For example, pass full cstyle, applicable lint rules, etc. |
| 26 | |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 27 | All new code must be licensed under CDDL, and modifications to existing |
| 28 | code may not alter the original license terms. Integrations of code |
| 29 | from upstream sources that use another liberal open source license are |
| 30 | permissible, subject to approval of the advocates or developer council. |
| 31 | Exceptions to this policy shall require the approval of the developer |
| 32 | council. |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 33 | |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 34 | Commits should have comments of the following form: |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 35 | |
| 36 | 1234 This is a sample bug report synopsis |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 37 | 4567 If you have a second bug synopsis… |
| 38 | Reviewed by: Frodo Baggins <frodo.baggins@underhill.net> |
| 39 | Reviewed by: Legolas <elf-coder@mirkwood.org> |
| 40 | Approved by: Gandalf The Grey <rti-advocate@white-council.com> |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 41 | |
| Garrett D'Amore | 2ad7205 | 2010-09-13 15:21:36 -0700 | [diff] [blame] | 42 | Each commit must have at least one bug id that is listed in the |
| 43 | illumos-gate project at www.illumos.org. |
| 44 | |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 45 | RTI Advocates: advocates@lists.illumos.org |
| 46 | Developer Council: developer-council@lists.illumos.org |
| Garrett D'Amore | 969bc94 | 2010-07-29 16:07:59 -0700 | [diff] [blame] | 47 | |
| Yuri Pankov | bde2df3 | 2012-09-21 06:38:43 +0400 | [diff] [blame] | 48 | IRC channel: #illumos on irc.freenode.net |
| 49 | Mailing list: developer@lists.illumos.org |