Add Incubator Repositories Proposal as an official policy

VERIFIED WONTFIX

Status

defect
VERIFIED WONTFIX
11 years ago
7 years ago

People

(Reporter: davidwboswell, Unassigned)

Tracking

Firefox Tracking Flags

(Not tracked)

Details

()

Attachments

(1 attachment)

Reporter

Description

11 years ago
Mitchell would like to make the Incubator Repositories Proposal an official policy.  This would include creating a page on www.mozilla.org based on her blog post at

http://blog.lizardwrangler.com/2008/06/06/incubator-repositories-proposal/

and then updating the link on the Policies page to point to this new page and changing the link text from a proposal to a policy.  I'll post a draft version of that page for review soon.

Comment 1

11 years ago
Thanks David

In reviewing the discussion in .governance, I found this:

I'll see about adding something to the doc that makes it clear that an incubator repository doesn't automatically get the kind of testing, automation or build/release support that mozilla-central does, as per that part of the discussion thread. 

adding this as a reminder to me to get this included before the official policy is live
Reporter

Comment 2

11 years ago
Attached is a draft of an Incubator Repository Policy page that would live at

http://www.mozilla.org/hacking/incubator-repository.html

Please review and provide any comments.

In addition to adding this policy, the Committer's Policy page should include a link to this page.  One suggestion for where this link could go is in the introductory sentence.  We could change:

"This document describes steps required to become a Mozilla committer. This document applies to all potential contributors."

to

"This document describes steps required to become a Mozilla committer. This document applies to all potential contributors, except for people wanting access to an <a href="http://www.mozilla.org/hacking">incubator repository</a>."

The link could also be added somewhere else in the body of the Committer's Policy page if that works better.
Attachment #349856 - Flags: review?(mitchell)

Comment 3

11 years ago
Comment on attachment 349856 [details]
Draft Incubator Repository Policy page

><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
><HTML><HEAD>
>
>
>  <TITLE>Incubator Repository Policy</TITLE>
></HEAD><BODY>
>
><H1>Incubator Repositories Policy</H1>
>
><P>Incubator Repositories are a tool available to <A href="http://www.mozilla.org/owners.html">module owners</A> in the following circumstances:</P>
>
><OL>
><LI>the module owners are engaged in significant cooperative development with contributors who are not yet experienced enough with Mozilla to have commit access to the Mozilla source tree; and</LI>
><LI>it is impractical to break contributions into bug-sized patches and follow the standard review and check-in process, either because the scope of work makes this difficult, or the work is experimental and a precursor to patches that will eventually end up in Mozilla-central or another reason the module owners can describe persuasively.</LI>
></OL>
>
><P>In other words, an Incubator Repository is a temporary repository hosted by Mozilla where we allow people to check code in before they have official source code write access for our production code base.  An Incubator Repository is not needed for repositories where all contributors have full source code commit access.</P>
>
><P><STRONG>An Incubator Repository should meet the following conditions:</STRONG></P>
>
><UL>
><LI>An incubator repository requires 2 module owners to be committed as sponsors.</LI>
><LI>The work is important to Mozilla's stated development roadmap; Incubator Repositories are not a hosting site for potentially-related  work.</LI>
><LI>The work is not duplicative of work in mozilla-central.  There is some possibility that duplicative incubator repositories are possible, we can look at that if the setting arises.</LI>
><LI>Incubator branches are temporary. In general, an incubator branch probably shouldn't last longer than six months. By that time it should be clear whether the work has potential. And if it is an effective branch, there should be enough activity from the contributors to determine which if any of them are ready for commit access. However, setting a one-size-fits-all date for all which must be tracked for its own sake requires a bureaucracy to track and manage that. Instead, we'll say that six months is the general timeframe. For a branch to last longer, the sponsors should have a good rationale why this is the case, they should ideally make that rationale to the Incubator Repositories module owner, and they <STRONG>must</STRONG> make that case effectively if the Incubator Repositories module owner or peers ask.</LI>
><LI>Incubator Repositories are publicly available repositories just like mozilla-central.</LI>
><LI>Incubator Repositories incubate both code and people. They are not training branches where the code doesn't matter. They are not intended to provide examples of coding to evaluate someone's readiness for commit access; we have policies for that. They are intended to help the sponsors make progress that otherwise wouldn't be possible while new contributors learn about Mozilla and become known to Mozilla.</LI>
><LI>Participants in an Incubator Repository may also develop patches that relate to the work in mozilla-central, for example a patch relating to start-up performance. When this happens, the patch or patches in question should be submitted through the standard process. This not only improves our code, but it provides a chance for the author's work to become known, which is necessary for commit-access outside the Incubator Repository. The sponsors are responsible for encouraging this process.</LI>
><LI>There is no right of potential contributors to have an incubator repository because it is easier for them. There is the ability of existing module owners to sponsor one.</LI>
><LI>The sponsors are responsible for the operation of the Incubator Repository.</LI>
></UL>
>
><P><STRONG>Logistics and Operational Parameters</STRONG></P>
>
><UL>
><LI>The creation of an Incubator Repository must be approved by the owner (or a designated peer) of the <A href="https://wiki.mozilla.org/Module_Owners_Activities_Modules">Incubator Repository module</A>. </LI>
><LI>The proposal should describe why the Incubator Repository meets the required conditions, who the sponsors are, hoped-for results of the Incubator Repository, the approximate number of people likely to be given check-in access through this process, and any possible effects on other parts of Mozilla.</LI>
><LI>The proposal should also be filed as a bug and also posted in the relevant newsgroup.</LI>
><LI>The sponsors are responsible for figuring out a reasonable system for getting code from the Incubator Repository into mozilla-central. "Reasonable" generally does not mean dropping six months of work on reviewers and asking for code review. Sponsors may meet this responsibility by using Mozilla code-review techniques in the Incubator Repository or by other means, but they are responsible for getting code review in reasonable increments.</LI>
><LI>Approval as an Incubator Repository does not provide any testing, automation or build/release support.</LI>
><LI>Anyone checking into an Incubator Repository must have signed a CVS Contributor Form on file with the Mozilla Foundation.</LI>
><LI>Once approval for an Incubator Repository has been granted and recorded in the appropriate bug, the sponsor or Incubator participants should file a bug asking for commit access for that person for the Incubator Repository. Details on filing the bug and getting it closed are below.</LI>
></UL>
>
><A name="commit"/>
><P><STRONG>Incubator Commit Access</STRONG></P>
>
><P>Here's a list of the steps that need to happen to get Incubator Commit Access.</P>
>
><OL>
><LI>Make sure the creation of the Incubator Repository to which you wish access has been approved.</LI>
><LI>File a bug. Product: mozilla.org; Component: CVS AccountRequest. Don't change the Default Assignee or the  Default QA Contact.  Your summary should say something about creating an Incubator Account ("Incubator Account Request - John Doe &lt;jdoe@example.com&gt;").  You should also include in the bug a pointer to the earlier bug in which the creation of the Incubator Repository in question was approved.</LI>
><LI>Each of the two sponsors should comment in the bug saying s/he's sponsoring the Incubator Repository and your participation in it.</LI>
><LI>Make sure to include your CVS SSH public key as an attachment to the bug. (Please mark it as text/plain when attaching it!) Note that you will need to attach an SSH key for all types of access.</LI>
><LI>Complete the Contribution Form and fax it to the location specified on the Form.</LI>
><LI>Update the bug to note that you've faxed in the Form.</LI>
><LI>An appropriate Mozilla representative will update the bug to say whether s/he has received the faxed Form.</LI>
><LI>Update the bug when all the needed info is in the bug. This way, Bugzilla can send off mail to the Mozilla representative tending to accounts.</LI>
><LI>The Mozilla representative will double-check that the needed info is recorded and, if so, create an account.</LI>
><LI>The Mozilla representative will then reassign the bug to IT to have your SSH public key added.</LI>
><LI>A Mozilla IT representative will update the bug with account creation information and close the bug.</LI>
></OL>
>
></BODY></HTML>

Comment 4

11 years ago
Three edits in the above:

1.  Removed this line:  (This is a new module which we will create as part of the implementation of this policy assuming it is approved.)
2.  Made "incubator Repository module" a link to https://wiki.mozilla.org/Module_Owners_Activities_Modules.  Eventually this should be a link to #Incubator Reposity Module on that page, but we need to create that section first. 
3.  Added this bullet item:  "Approval as an Incubator Repository does not provide any testing, automation or build/release support.  Nor does it imply that these support "

Comment 5

11 years ago
(In reply to comment #2)
the Committer's Policy page should include a
> link to this page.  One suggestion for where this link could go is in the
> introductory sentence.  We could change:
> 
> "This document describes steps required to become a Mozilla committer. This
> document applies to all potential contributors."
> 
> to
> 
> "This document describes steps required to become a Mozilla committer. This
> document applies to all potential contributors, except for people wanting
> access to an <a href="http://www.mozilla.org/hacking">incubator
> repository</a>."
> 
David, this seems fine to me
Reporter

Comment 6

11 years ago
I posted the Incubator Repository Policy page with the changes Mitchell made above and added a link from the Committer's Policy and Official Policies pages.  If there are any other changes to make, let me know.  We can also leave this bug open until we get the correct link for the Incubator Reposity Module.  The pages should be up on the site in a few minutes at:

http://www.mozilla.org/hacking/incubator-repository.html
The "Logistics and Operational Parameters" section is outdated and needs some editing, but I guess I can fix that myself sometime.
OS: Mac OS X → All
Hardware: PC → All

Comment 8

11 years ago
(In reply to comment #2)
the Committer's Policy page should include a
> link to this page.  One suggestion for where this link could go is in the
> introductory sentence.  We could change:
> 
> "This document describes steps required to become a Mozilla committer. This
> document applies to all potential contributors."
> 
> to
> 
> "This document describes steps required to become a Mozilla committer. This
> document applies to all potential contributors, except for people wanting
> access to an <a href="http://www.mozilla.org/hacking">incubator
> repository</a>."
> 
David, this seems fine to me
OS: All → Mac OS X
Hardware: All → PC

Comment 9

11 years ago
(In reply to comment #7)
> The "Logistics and Operational Parameters" section is outdated and needs some
> editing, but I guess I can fix that myself sometime.
Reed -- can you say more what you mean?  Or post a revised version here so i can see what's outdated?
(In reply to comment #9)
> (In reply to comment #7)
> > The "Logistics and Operational Parameters" section is outdated and needs some
> > editing, but I guess I can fix that myself sometime.
>
> Reed -- can you say more what you mean?  Or post a revised version here so i
> can see what's outdated?

Yeah, I will. Just a tad busy with school stuff right now, but I'll try to get to it in the next day or so.
OS: Mac OS X → All
Hardware: PC → All

Updated

11 years ago
Depends on: 478387
Reporter

Comment 12

9 years ago
Adding Gerv to see if there's anything we need to do to close this out.  The Incubator Repository page is live on the site now so we should update it if there is anything out of date as mentioned in comment #7.
The incubator repository program has now been retired, as noted in mozilla.governance:
http://groups.google.com/group/mozilla.governance/browse_thread/thread/7ee724846aa2b1ad#

Gerv
Status: NEW → RESOLVED
Closed: 9 years ago
Resolution: --- → WONTFIX

Updated

7 years ago
Status: RESOLVED → VERIFIED
Component: www.mozilla.org → General
Product: Websites → www.mozilla.org
You need to log in before you can comment on or make changes to this bug.