From ecb86072d2459178dbe925c1ea046e7447d399eb Mon Sep 17 00:00:00 2001 From: jpellerin Date: Mon, 27 Apr 2009 15:33:12 -0400 Subject: Added basic contributing page --- doc/contributing.rst | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 doc/contributing.rst (limited to 'doc/contributing.rst') diff --git a/doc/contributing.rst b/doc/contributing.rst new file mode 100644 index 0000000..5297ed6 --- /dev/null +++ b/doc/contributing.rst @@ -0,0 +1,63 @@ +Contributing to nose +==================== + +You'd like to contribute to nose? Great! Now that nose is hosted under +`Mercurial `__, contributing is even easier. + +Get the code! +------------- + +Start by getting a local working copy of nose. + +.. code-block:: none + + hg clone FIXME FIXME FIXME + +Next, if you plan to push changes back to the core repository, you +should set up a public repository of your own somewhere. `Bitbucket +`__ is one good place to do that. Once you've +set up your bitbucket nose repository, pull from your working copy of +nose core, and push to bitbucket. That (with occasional merging) will +be your normal practice for keeping your repository up to date. + +Discuss +------- + +Join the `nose developer list +`__ at google groups. It's +low-traffic and mostly signal. + +What to work on? +---------------- + +You can find a list of open issues at nose's `google code repository +`__. If you'd like to +work on an issue, leave a comment on the issue detailing how you plan +to fix it, and where to find the Mercurial repository where you will +publish your changes. + +Actually, I want to work on the python 3.0 version +-------------------------------------------------- + +The python 3.0 version of nose, nose3, is hosted at bitbucket. You can +clone the repository from here:: + + hg clone http://bitbucket.org/jpellerin/nose3 + +If you plan to contribute changes back, you should fork the repository +on bitbucket. + +Issues affecting nose3 should likewise be reported at the bitbucket +site, not at google code. + +nose3 hosting may move to google code at some future date, when or if google +code supports bitbucket-style forking. + +I have a great idea for a plugin... +----------------------------------- + +Great! :doc:`Write it `. Release it on `pypi +`__. If it gains a large following, and +becomes stable enough to work with nose's 6+ month release cycles, it +may be a good candidate for inclusion in nose's builtin plugins. + -- cgit v1.2.1