changeset 5972:653fee8db519

docs: mention preference for non-publishing repositories for pull requests
author Konstantin Veretennicov <kveretennicov@gmail.com>
date Wed, 15 Jun 2016 21:09:03 +0200
parents a5a16aad6b3e
children 7253d9974bbe
files docs/contributing.rst
diffstat 1 files changed, 9 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/docs/contributing.rst	Wed Jun 15 21:12:39 2016 +0200
+++ b/docs/contributing.rst	Wed Jun 15 21:09:03 2016 +0200
@@ -131,9 +131,17 @@
 .. _English title case: https://en.wikipedia.org/wiki/Capitalization#Title_case
 
 Contributions will be accepted in most formats -- such as pull requests on
-bitbucket, something hosted on your own Kallithea instance, or patches sent by
+Bitbucket, something hosted on your own Kallithea instance, or patches sent by
 email to the `kallithea-general`_ mailing list.
 
+When contributing via Bitbucket, please make your fork of
+https://bitbucket.org/conservancy/kallithea/ `non-publishing`_ -- it is one of
+the settings on "Repository details" page. This ensures your commits are in
+"draft" phase and makes it easier for you to address feedback and for project
+maintainers to integrate your changes.
+
+.. _non-publishing: https://www.mercurial-scm.org/wiki/Phases#Publishing_Repository
+
 Make sure to test your changes both manually and with the automatic tests
 before posting.