readme.md updated with more info about development
authorSergey Karayev <sergeykarayev@gmail.com>
Mon, 17 Mar 2014 17:43:28 +0000 (10:43 -0700)
committerSergey Karayev <sergeykarayev@gmail.com>
Mon, 17 Mar 2014 17:43:28 +0000 (10:43 -0700)
README.md

index 57229b549714f5d71a63b3bd7b28385ead67a41a..8dc3faec8582ecb804f2044afbcdd34fa1c9e21a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -57,20 +57,28 @@ To do so, simply run `jekyll serve -s docs` and view the documentation website a
 We strive to provide provide lots of usage examples, and to document all code in docstrings.
 We'd appreciate your contribution to this effort!
 
-## Contributing
+## Development
 
 Caffe is developed with active participation of the community by the [Berkeley Vision and Learning Center](http://bvlc.eecs.berkeley.edu/).
 We welcome all contributions!
 
-Our workflow is this:
+### The release cycle
+
+- The `dev` branch is for new development, including community contributions. We aim to keep it in a functional state, but large changes may occur and things may get broken every now and then. Use this if you want the "bleeding edge".
+- The `master` branch is handled by BVLC, which will integrate changes from `dev` on a roughly monthly schedule, giving it a release tag. Use this if you want more stability.
+
+### Setting priorities
+
+- Make Github Issues for bugs, features you'd like to see, questions, etc.
+- Development work is guided by [milestones](https://github.com/BVLC/caffe/issues?milestone=1), which are sets of issues selected for concurrent release (integration from `dev` to `master`).
+- Please note that since the core developers are largely researchers, we may work on a feature in isolation from the open-source community for some time before releasing it, so as to claim honest academic contribution. We do release it as soon as a reasonable technical report may be written about the work, and we still aim to inform the community of ongoing development through Issues.
+
+### Contibuting
 
-- The `dev` branch is for new development, community contributions, and testing.
-- The `master` branch is handled by BVLC, which will integrate changes from `dev` on a roughly monthly schedule.
 - Do new development in [feature branches](https://www.atlassian.com/git/workflows#!workflow-feature-branch) with decriptive names.
 - Bring your work up-to-date by [rebasing](http://git-scm.com/book/en/Git-Branching-Rebasing) onto the latest `dev`. (Polish your changes by [interactive rebase](https://help.github.com/articles/interactive-rebase), if you'd like.)
 - [Pull request](https://help.github.com/articles/using-pull-requests) your contribution to BVLC/caffe's `dev` branch for discussion and review.
-  * PRs should live fast, die young, and leave a beautiful merge. Pull
-    request sooner than later so that discussion can guide development.
+  * PRs should live fast, die young, and leave a beautiful merge. Pull request sooner than later so that discussion can guide development.
   * Code must be accompanied by documentation and tests at all times.
   * Only fast-forward merges will be accepted.