xref: /titanic_41/README (revision 969bc941052c29943dfb40d55089dc56fa46be57)
1*969bc941SGarrett D'AmoreIllumos Gate README - July 29, 2010.
2*969bc941SGarrett D'Amore
3*969bc941SGarrett D'AmoreThis is the Illumos gate.  It contains the following subdirectories:
4*969bc941SGarrett D'Amore
5*969bc941SGarrett D'Amore        - usr/src -- this is a clone (with changes) of the Oracle ONNV gate.
6*969bc941SGarrett D'Amore          We should avoid making too many disruptive changes here.  It
7*969bc941SGarrett D'Amore          will be periodically synced with ONNV.
8*969bc941SGarrett D'Amore
9*969bc941SGarrett D'Amore        - usr/illumos -- this is the set of bits that we deliver, which are not
10*969bc941SGarrett D'Amore          yet integrated into the onnv tree.  This may include various
11*969bc941SGarrett D'Amore          testing bits, etc.  These bits (for whatever reason), are things
12*969bc941SGarrett D'Amore          that we think are inappropriate for inclusion in the upstream and
13*969bc941SGarrett D'Amore	  really are specific to illumos.
14*969bc941SGarrett D'Amore
15*969bc941SGarrett D'AmoreIntegration Rules:
16*969bc941SGarrett D'Amore
17*969bc941SGarrett D'Amore        All changes must have been reviewed, and (for the interim only!)
18*969bc941SGarrett D'Amore        approved by the gatekeeper (below).  A code review may be performed
19*969bc941SGarrett D'Amore        by someone other than the gatekeeper, but the final integration should
20*969bc941SGarrett D'Amore        still be approved by the gatekeeper.  (Think CRT advocate for now.)
21*969bc941SGarrett D'Amore        The gatekeeper will want to see your webrev and hg outgoing -v.
22*969bc941SGarrett D'Amore
23*969bc941SGarrett D'Amore        All changes must adhere to typical ON style and quality rules.
24*969bc941SGarrett D'Amore        For example, pass full cstyle, applicable lint rules, etc.
25*969bc941SGarrett D'Amore
26*969bc941SGarrett D'Amore        All commits must include either a CDDL or BSD/MIT license, unless
27*969bc941SGarrett D'Amore        approved otherwise by the gatekeeper.  CDDL licensed changes must
28*969bc941SGarrett D'Amore        be backed by a Sun Contributor Agreement, so that the changes can
29*969bc941SGarrett D'Amore        be contributed to the upstream OpenSolaris consolidation.
30*969bc941SGarrett D'Amore
31*969bc941SGarrett D'Amore        Hg commits should have comments of the following form:
32*969bc941SGarrett D'Amore
33*969bc941SGarrett D'Amore        1234 This is a sample bug report synopsis
34*969bc941SGarrett D'Amore        4567 If you have a second bug synopsis...
35*969bc941SGarrett D'Amore        Reviewed by: codereviewer@somewhere.net
36*969bc941SGarrett D'Amore        Approved by: gatekeeper@somewhere.else.com
37*969bc941SGarrett D'Amore
38*969bc941SGarrett D'AmoreBranches:
39*969bc941SGarrett D'Amore
40*969bc941SGarrett D'Amore        Please talk to the gatekeeper about personal branches.  In general,
41*969bc941SGarrett D'Amore        they will be allowed as long as we don't go *too* wild on them.
42*969bc941SGarrett D'Amore
43*969bc941SGarrett D'AmoreGatekeeper:     garrett@nexenta.com  (Interim)
44*969bc941SGarrett D'AmoreIRC channel:    #illumos on irc.freenode.net
45*969bc941SGarrett D'AmoreMailing list:   developer@lists.illumos.org
46*969bc941SGarrett D'Amore
47