|
Size: 4678
Comment:
|
Size: 10404
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #pragma page-filename DEV/versions/786435 | #pragma page-filename DEV/versions/9 |
| Line 3: | Line 3: |
| == General development resources == Here are some general Mailman development resources. |
|
| Line 6: | Line 4: |
| * Mailman development is moving to the [[http://www.bazaar-vcs.org|Bazaar]] distributed revision control system, with branches hosted on [[http://launchpad.net|Launchpad]]. Here is more detail on how to [[../MailmanOnLaunchpad|develop Mailman code using Bazaar and Launchpad]]. == Versions specific resources == Here are the collection of resources for people interested in the development of Mailman. |
Thank you for contributing to Mailman! Please also see the [[../../Mailman3|Mailman 3]] release notes. See the [[../MailmanOnLaunchpad|quick start]]. == Contributing to Mailman, step 1: Git and Gitlab == Mailman 3's source code is published in [[http://git-scm.com/|git]]. Project management is available on [[https://gitlab.com/mailman/mailman|Gitlab]]. We switched from Bazaar on Launchpad on May 4th, 2015. Previous to that, we switched from Subversion on !SourceForge on June 22, 2007. '''Please note:''' Mailman 2.1 development continues to be hosted in Bazaar on [[../MailmanOnLaunchpad|Launchpad]]. For now, the Mailman 3 branch on Launchpad will continue to be available in read-only mode. == Contributing to Mailman, step 2: Contribution workflow process == 1. A developer has an idea for an enhancement. They discuss it on the [[http://mail.python.org/mailman/listinfo/mailman-developers|mailman-developers]] mailing list. For higher bandwidth discussions we can use irc (#mailman channel on [[irc://irc.freenode.net|irc://irc.freenode.net]]). Channel logs [[https://botbot.me/freenode/mailman/|are available]]. 1. Developers can clone our git repository, push their own branches, and submit [[https://gitlab.com/mailman/mailman/merge_requests|a merge request]] against the official branches. 1. If the idea is appropriate for GNU Mailman and we decide to include it, FSF must get copyright assignments from the developer. See below. Do this early, since it can take some time to get all the paperwork to the FSF. == Branch development guidelines == * Branches should be self-contained: Include documentation, a NEWS entry, and tests. Ideally, there would be one bug for every branch. * Be sure your branch does not provoke any regressions. Run {{{tox}}} on your branch and be sure everything passes. Eventually, we'll enable CI on Gitlab so you'll know immediately whether your branch is ready for merging. * Branches should be as small as possible. The smaller the branch the easier it is to review. == Contributing to Mailman, step 3: Copyright assignment == Mailman is a [[http://www.gnu.org|GNU]] project with the majority of the copyrights being held by the [[http://www.fsf.org|Free Software Foundation]]. We therefore request that developers who contribute code, assign their copyrights in their Mailman contribution to the FSF. To do this, you first need to submit a [[../GNU copyright assignment request form|GNU copyright assignment request form]] containing some basic information, and then fill out the form that the FSF sends you. Please [[mailto:mailman-cabal@python.org|let us know]] after you've sent the second form so that we can track your contribution. The FSF often doesn't tell us in a timely manner when such forms have been received. == Version-specific resources == Mailman's developers are currently focused mostly on working towards the release of Mailman 3.0. |
| Line 11: | Line 37: |
| * [[../Mailman 2.2|Mailman 2.2]] * [[../Mailman 3.0|Mailman 3.0]] |
* [[../Mailman 2.2|Mailman 2.2]] -- 2.1 is the stable branch, now in maintenance mode * [[../Mailman 3.0|Mailman 3.0]] -- 3.0 is the stable Mailman 3 release * [[../Mailman 3.1|Mailman 3.1]] * [[../Mailman 3.2|Mailman 3.2]] == Sprints == * [[../Google_Summer_of_Code_2015|Google Summer of Code 2015]] * [[../PyCon 2015 Sprint|PyCon 2015 Sprint]] * [[../Google Summer of Code 2014|Google Summer of Code 2014]] * [[../PyCon 2014 Sprint|PyCon Sprint 2014]] * [[../Google Summer of Code 2013|Google Summer of Code 2013]] * [[../PyCon Sprint 2013|PyCon Sprint 2013]] * [[../Google Summer of Code 2012|Google Summer of Code 2012]] * [[../Google Summer of Code 2011|Google Summer of Code 2011]] * [[http://wiki.list.org/display/DEV/GHC12+Open+Source+Day+Hackathon|GHC12 Open Source Day Hackathon]] * [[../Google Summer of Code 2011|Google Summer of Code 2011]] * [[../PyCon Sprint 2010|PyCon Sprint 2010]] * [[../PyCon Sprint 2009|PyCon Sprint 2009]] * [[../Google Summer of Code 2008|Google Summer of Code 2008]] * [[../Google_Summer_of_Code_2006|Google Summer of Code 2006]] |
| Line 14: | Line 60: |
* [[../New Logos|New Logos]] * [[../GPLv3|GPLv3]] |
|
| Line 15: | Line 64: |
| * [[../DKIM|DKIM]] | * [[../DKIM|DKIM]] and [[../DMARC|DMARC]] |
| Line 19: | Line 68: |
| * Web U/I: [[../StyledPages|Using CSS]], [[../TemplatingNotes|Adding templating]] == Other developer information == Google did a [[http://code.google.com/soc/|2006 Summer of Code]]program in 2006, and Mailman was a sponsor. See the [[../Summer of Code|Summer of Code]] page and [[../Mailman 2.2|Mailman 2.2]] page for more information. |
* [[../Stable URLs|Stable URLs]] * [[../Patches|Patches]] * [[../ReplyTo|ReplyTo]] * [[../Usability|Usability]] * [[../ModernArchiving|Modern Archiving]] (currently HyperKitty in [[../Mailman 3.0|Mailman 3]]) * [[../Postorius Web Interface|Postorius Web Interface]] (in [[../Mailman 3.0|Mailman 3]]) * [[../REST Interface|REST Interface]] (a part of [[../Mailman 3.0|Mailman 3]] core) |
| Line 23: | Line 76: |
| Mailman is a [[http://www.gnu.org|GNU]] project with the majority of the copyrights being held by the [[http://www.fsf.org|Free Software Foundation]]. We therefore request that developers who contribute code, assign their copyrights in their Mailman contribution to the FSF. To do this, you first need to submit a [[../GNU copyright assignment request form|GNU copyright assignment request form]] containing some basic information, and then fill out the form that the FSF sends you. Please [[mailto:mailman-cabal@python.org|let us know]]after you've sent the second form so that we can track your contribution. The FSF often doesn't tell us in a timely manner when such forms have been received. | == Suggestions == People seem to have trouble figuring out where to make suggestions or feature requests. There is a [[../suggestions|suggestions]] page here, or you may wish to start a discussion on the [[http://mail.python.org/mailman/listinfo/mailman-developers|mailman-developers list]] |
| Line 26: | Line 81: |
| Here are some useful references: | Here are some useful RFCs, references and drafts: |
| Line 31: | Line 87: |
| RFCs and drafts: | * [[http://www.faqs.org/rfcs/rfc3834.html|RFC 3834 - Recommendations for Automatic Responses to Electronic Mail]] * [[http://tools.ietf.org/html/rfc5064|RFC 5064 - The Archived-At Message Header Field]] '''draft''' * [[http://www.faqs.org/rfcs/rfc2033.html|RFC 2033 - Local Mail Transfer Protocol]] * [[http://www.ietf.org/rfc/rfc4871.txt?number=4871|RFC 4871]][[http://www.dkim.org|DomainKey Identified Mail (DKIM)]] * [[http://www.openid.net|OpenID]] * [[http://www.faqs.org/rfcs/rfc1893.html|RFC 1893 - Enhanced Mail System Status Codes]] * [[http://www.faqs.org/rfcs/rfc2034.html|RFC 2034 - SMTP Service Extension for Returning Enhanced Error Codes]] * [[http://en.wikipedia.org/wiki/Bounce_Address_Tag_Validation|Bounce Address Tag Validation (BATV)]] * [[http://www.ietf.org/id/draft-shafranovich-feedback-report-07.txt|Extensible Format for Email Feedback Reports]] * [[https://www.owasp.org/index.php/Forgot_Password_Cheat_Sheet|Forgotten Password recommendations from OWASP]] * [[http://www.faqs.org/rfcs/rfc6530.html|RFC 6530 - Overview and Framework for Internationalized Email]] * [[http://www.faqs.org/rfcs/rfc6531.html|RFC 6531 - SMTP Extension for Internationalized Email]] * [[http://www.faqs.org/rfcs/rfc6532.html|RFC 6532 - Internationalized Email Headers]] |
| Line 33: | Line 101: |
| * [[http://www.faqs.org/rfcs/rfc2033.html|RFC 2033 - Local Mail Transfer Protocol]] * [[http://www.dkim.org|DomainKey Identified Mail (DKIM) draft specs]] * [[http://www.openid.org|OpenID]] |
Best practices: * OWASP's [[https://www.owasp.org/index.php/Forgot_Password_Cheat_Sheet|password reset]] recommendations * Anti-spam and anti-backscatter<<BR>> * [[http://wiki.exim.org/EximAutoReply|How To Do Autoreplies Without The World Hating You]]. * A talk given at a UK Unix User Group meeting. Look for the 5th abstract on [[http://www.ukuug.org/events/winter2005/programme.shtml|this page]]. * [[http://www.dontbouncespam.org/|http://www.dontbouncespam.org/]] * [[http://spamlinks.net/prevent-secure-backscatter.htm|http://spamlinks.net/prevent-secure-backscatter.htm]] * The inevitable [[http://mayfirst.org/?q=node/180|"...considered harmful" article]]. * UK Joint Academic Network (JANet) provides network connectivity and services for UK * HE institutions has [[http://www.ja.net/services/csirt/advice/policies/collateral-spam.html|guidance to victims of backscatter]]. * ...and to system adminstrators [[http://www.ja.net/services/csirt/threats/bounce.html|Spam Bounces Considered Harmful]]. * [[http://mipassoc.org/batv/|Bounce Address Tag Validation (BATV)]] * Mailman's own recommendations for [[../../SEC/Controlling spam|controlling spam]] |
| Line 51: | Line 130: |
| * [[DEV/Google Summer of Code 2015|Google Summer of Code 2015]] * [[DEV/Google Summer of Code 2016|Google Summer of Code 2016]] |
|
| Line 64: | Line 145: |
| * [[DEV/PyCon 2014 Sprint|PyCon 2014 Sprint]] | |
| Line 68: | Line 148: |
| * [[DEV/PyCon 2014 Sprint|PyCon 2014 Sprint]] * [[DEV/PyCon 2015 Sprint|PyCon 2015 Sprint]] |
Mailman Developer Resources
Thank you for contributing to Mailman! Please also see the Mailman 3 release notes.
See the quick start.
Contributing to Mailman, step 1: Git and Gitlab
Mailman 3's source code is published in git. Project management is available on Gitlab. We switched from Bazaar on Launchpad on May 4th, 2015. Previous to that, we switched from Subversion on SourceForge on June 22, 2007.
Please note: Mailman 2.1 development continues to be hosted in Bazaar on Launchpad.
For now, the Mailman 3 branch on Launchpad will continue to be available in read-only mode.
Contributing to Mailman, step 2: Contribution workflow process
A developer has an idea for an enhancement. They discuss it on the mailman-developers mailing list. For higher bandwidth discussions we can use irc (#mailman channel on irc://irc.freenode.net). Channel logs are available.
Developers can clone our git repository, push their own branches, and submit a merge request against the official branches.
- If the idea is appropriate for GNU Mailman and we decide to include it, FSF must get copyright assignments from the developer. See below. Do this early, since it can take some time to get all the paperwork to the FSF.
Branch development guidelines
- Branches should be self-contained: Include documentation, a NEWS entry, and tests. Ideally, there would be one bug for every branch.
Be sure your branch does not provoke any regressions. Run tox on your branch and be sure everything passes. Eventually, we'll enable CI on Gitlab so you'll know immediately whether your branch is ready for merging.
- Branches should be as small as possible. The smaller the branch the easier it is to review.
Contributing to Mailman, step 3: Copyright assignment
Mailman is a GNU project with the majority of the copyrights being held by the Free Software Foundation. We therefore request that developers who contribute code, assign their copyrights in their Mailman contribution to the FSF. To do this, you first need to submit a GNU copyright assignment request form containing some basic information, and then fill out the form that the FSF sends you. Please let us know after you've sent the second form so that we can track your contribution. The FSF often doesn't tell us in a timely manner when such forms have been received.
Version-specific resources
Mailman's developers are currently focused mostly on working towards the release of Mailman 3.0.
Mailman 2.2 -- 2.1 is the stable branch, now in maintenance mode
Mailman 3.0 -- 3.0 is the stable Mailman 3 release
Sprints
Initiatives and proposals
Modern Archiving (currently HyperKitty in Mailman 3)
REST Interface (a part of Mailman 3 core)
Suggestions
People seem to have trouble figuring out where to make suggestions or feature requests. There is a suggestions page here, or you may wish to start a discussion on the mailman-developers list
Relevant RFCs, references, and standards
Here are some useful RFCs, references and drafts:
A Highly Scalable Electronic Mail Service Using Open Systems (Christenson, et al)
RFC 3834 - Recommendations for Automatic Responses to Electronic Mail
RFC 2034 - SMTP Service Extension for Returning Enhanced Error Codes
RFC 6530 - Overview and Framework for Internationalized Email
Best practices:
OWASP's password reset recommendations
Anti-spam and anti-backscatter
A talk given at a UK Unix User Group meeting. Look for the 5th abstract on this page.
The inevitable "...considered harmful" article.
- UK Joint Academic Network (JANet) provides network connectivity and services for UK
HE institutions has guidance to victims of backscatter.
...and to system adminstrators Spam Bounces Considered Harmful.
Mailman's own recommendations for controlling spam