canmove, Confirmed users, Bureaucrats and Sysops emeriti
1,093
edits
Labs/Bespin/Contributing: Difference between revisions
no edit summary
No edit summary |
No edit summary |
||
| Line 28: | Line 28: | ||
# Create a patch for your changes | # Create a patch for your changes | ||
# Create a "bundle" for your changes (a bundle is a mercurial-specific format that includes every commit, rather than just a snapshot of the difference) | # Create a "bundle" for your changes (a bundle is a mercurial-specific format that includes every commit, rather than just a snapshot of the difference) | ||
The recommended approach is to create a public repository (such as one on bitbucket.org) that we can pull from. In order to ensure that we can easily make use of your changes, '''you should put the changes on separate branches, preferably using hg bookmarks'''. You can learn a bit about branching and bookmarks in [http://stevelosh.com/blog/entry/2009/8/30/a-guide-to-branching-in-mercurial/#branching-with-bookmarks A Guide to Branching in Mercurial]. Some specific tips: | |||
* Separate branches would be used for unrelated bugs and features, so that we can pull one without having to pull another | |||
* You'll have an easier time keeping a repository up to date than a patch, which is why this is the recommended approach | |||
* Having separate branches in your repo using bookmarks is easier than having lots of separate repositories that would all need to be set up and configured | |||
* hg bookmarks do not get pushed to the remote repository. So, when telling us that you want us to pull from you, be sure to give us the full commit ID. You can get this with <tt>hg id -r bookmarkname</tt>. Also be sure to tell us where your repository is! | |||
* In the related bug in bugzilla, add a [needs-pull] flag to the whiteboard, so that we can easily spot that we have incoming code. | |||
You can submit the enhancements as an [https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Labs&component=Bespin attachment in Bugzilla]. | You can submit the enhancements as an [https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Labs&component=Bespin attachment in Bugzilla]. | ||