Changes between Version 1 and Version 2 of NewCommittersGuide

Timestamp:

Nov 4, 2006, 8:45:51 AM (18 years ago)

Author:

markd@…

Comment:

--

NewCommittersGuide

@@ -1 @@
-The following apply to those who are committing port-level svn updates to MacPorts (these may yet not be complete or completely correct, but it is a start):
+== Requesting Commit Rights ==
+
+Once you have a track record as a maintainer (achieved by all-around good works such as submitting new ports with yourself as a maintainer, submitting bug fixes for existing ports, etc), we encourage you to apply for commit status so that you can easilly keep your ports up to date and participate in keeping MacPorts such a strong community. If you feel you are ready for commit rights, please send an email to mailto:macports-mgr@lists.macosforge.org, with the title "Request for Commit Rights" and a short explanation for why you deserve commit rights.
+
+== Port Committer Responsibilities ==
 
  1. PortIndex is now updated automatically (every 12 hours) so it must not be touched
@@ -8 +12 @@
   3.3. You need to change your email address for your ports[[BR]]
   3.4. Other, similar reasons[[BR]]
- 4. All committers must subscribe to the [http://www.opendarwin.org/mailman/listinfo/cvs-darwinports-all cvs-darwinports-all] list under their OpenDarwin credentials to keep track of current changes and because the list is subscriber-post-only, so commit messages will otherwise be rejected
+ 4. All committers must subscribe to the [http://lists.macosforge.org/mailman/listinfo/macports-changes macports-changes] list under their MacPorts credentials to keep track of current changes and because the list is subscriber-post-only, so commit messages will otherwise be rejected
  5. New top-level categories (those which are represented by directories in the MacPorts tree) need to be approved prior to adding; secondary categories (the second and later ones listed on the '''categories''' Portfile key) can be added when it makes sense (since these really only show under the web interface, and have no filesystem representation)
  6. Make sure the port name matches between the MacPorts svn directory name and the '''name''' Portfile key (while the system works fine when they don't, keeping them synchronized avoids confusing situations)
@@ -19 +23 @@
 
 This began with [http://www.opendarwin.org/pipermail/darwinports/2005-November/029252.html a post] on the MacPorts [http://www.opendarwin.org/mailman/listinfo/darwinports email list].
+
+== Mailing Lists and Change Logs ==
+
+Notification of change logging is either via the [http://lists.macosforge.org/mailman/listinfo/macports-changes macports-changes] list or by subscribing to the RSS feeds provided by trac (see the RSS feeds of the [/projects/macports/timeline Timeline view] and the [/projects/macports/log/trunk Source Repository]). Note that you may customize the Timeline prior to subscribing to it, in order to control which types of information you are fed. In addition to getting an RSS feed of [wiki:TracTimeline general project events], you may also subscribe to changes to some [wiki:TracBrowser portion of the source tree] or to [wiki:TracQuery bug reports/tickets].
+
+If you use a newsreader such as [http://www.newsgator.com/NGOLProduct.aspx?ProdID=NetNewsWire NetNewsWire], and if you subscribe to the https version of the feed, you must ensure that you trust the certificate svn.macosforge.org from the certificate authority opensource.apple.com. You can tell Safari to "trust" this certificate when it sees it; you may need to set the trust settings for the certificate and/or authority from within Keychain access. Without these trust settings, NetNewsWire will not receive the feed. A better solution is to make sure that you subscribe to the http version of the feed (change the scheme on the URL to http from https).
+
+
+== Committer Addresses ==
+
+We prefer that those with commit rights use their @macports.org address when listing themselves as a committer. This helps other committers to distinguish maintainers who are committers from those who are not.
+
+Several special maintainer addresses are used to distinguish additional meta-information about ports. Please see SpecialMaintainerAddresses.