diff --git a/DEVELOPMENT.txt b/DEVELOPMENT.txt new file mode 100644 index 00000000..6aa43a68 --- /dev/null +++ b/DEVELOPMENT.txt @@ -0,0 +1,52 @@ +Development process +------------------- + * Go to `http://github.com/stefanv/scikits.image + `_ and follow the instructions on + making your own fork/branch. + * Make changes to your branch, committing locally as you progress. + * Push your changes back to github. + * Ping stefan to request a merge into the main development branch. + +.. note:: + + Do *not* merge the main branch into yours. You may rebase, + as long as you are `aware of its dangers `_ + (also see `LWN article `_). + +All of this may be intimidating if you've never used git before, so we'd +happily accept plain old unified diffs (``git diff`` or ``diff -u a.txt +b.txt``) as well. + +Guidelines: +``````````` + * All code should have tests (see "Test coverage" below for more details). + * All code should be documented, to the same + `standard `_ + as NumPy and SciPy. + * Follow the `Python PEPs `_ + where possible. + * All major changes should be `posted for review + `_ to the `mailing list + `_. + +Test coverage +````````````` +Tests for a module should ideally cover all code in that module, i.e. statement +coverage should be at 100%. To measure the test coverage, install ``_ and then run:: + + $ make coverage + +This will print a report with one line for each file in `scikits.image`, +detailing the test coverage:: + + Name Stmts Exec Cover Missing + ------------------------------------------------------------------------------ + scikits/image/color/colorconv 77 77 100% + scikits/image/filter/__init__ 1 1 100% + ... + +Bugs +```` +Please `report bugs on Github `_. + diff --git a/Makefile b/Makefile index 081e0d08..5a5dbc86 100644 --- a/Makefile +++ b/Makefile @@ -10,5 +10,4 @@ test: nosetests scikits/image coverage: - nosetests scikits/image --with-coverage - coverage -r -m scikits/image/*.py scikits/image/*/*.py + nosetests scikits/image --with-coverage --cover-package=scikits.image diff --git a/TASKS.txt b/TASKS.txt index 1ec192c7..35594899 100644 --- a/TASKS.txt +++ b/TASKS.txt @@ -24,7 +24,7 @@ or tests. * `Hough transform `_ * `Shortest paths `_ * `Grey-level co-occurrence matrices `_ - * Marching squares (investigate patent issues) + * Marching squares * Nadav's bilateral filtering (first compare against CellProfile's code) * 2D iso-contour finding (sub-pixel precision) [ask Zach Pincus] * 2D image warping via thin-plate splines [ask Zach Pincus] @@ -96,38 +96,3 @@ checking in the API files into the repository (done) -- but the doc build process needs to be updated to use these distributed files if they cannot be generated from source. -Development process -------------------- - * Go to `http://github.com/stefanv/scikits.image - `_ and follow the instructions on - making your own fork/branch. - * Make changes to your branch, committing locally as you progress. - * Push your changes back to github. - * Ping stefan to request a merge into the main development branch. - -.. note:: - - Do *not* merge the main branch into yours. You may rebase, - as long as you are `aware of its dangers `_ - (also see `LWN article `_). - -All of this may be intimidating if you've never used git before, so we'd -happily accept plain old unified diffs (``git diff`` or ``diff -u a.txt -b.txt``) as well. - -Guidelines: -``````````` - * All code should have tests. - * All code should be documented, to the same - `standard `_ - as NumPy and SciPy. - * Follow the `Python PEPs `_ - where possible. - * All major changes should be `posted for review - `_ to the `mailing list - `_. - -Bugs -```` -Please `report bugs on Github `_. - diff --git a/doc/source/api/api.txt b/doc/source/api/api.txt index 3b5b4ba1..921a226d 100644 --- a/doc/source/api/api.txt +++ b/doc/source/api/api.txt @@ -8,5 +8,4 @@ API Reference scikits.image.color scikits.image.filter scikits.image.io - scikits.image.opencv scikits.image.transform diff --git a/doc/source/contribute.txt b/doc/source/contribute.txt index 8ed8e081..5e62b585 100644 --- a/doc/source/contribute.txt +++ b/doc/source/contribute.txt @@ -1,2 +1,2 @@ .. include:: ../../TASKS.txt - +.. include:: ../../DEVELOPMENT.txt