From a66438e497303ce08d05cf8d76b2d5827e3e3578 Mon Sep 17 00:00:00 2001 From: Leo Famulari Date: Sun, 5 Mar 2023 14:54:06 -0500 Subject: doc: Give advice to contributors about communicating with reviewers. * doc/contributing.texi (Submitting Patches): Give advice. --- doc/contributing.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc/contributing.texi') diff --git a/doc/contributing.texi b/doc/contributing.texi index c436bc4a31..61c05c2489 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1170,6 +1170,16 @@ Please write commit logs in the ChangeLog format (@pxref{Change Logs,,, standards, GNU Coding Standards}); you can check the commit history for examples. +You can help make the review process more efficient, and increase the +chance that your patch will be reviewed quickly, by describing the +context of your patch and the impact you expect it to have. For +example, if your patch is fixing something that is broken, describe the +problem and how your patch fixes it. Tell us how you have tested your +patch. Will users of the code changed by your patch have to adjust +their workflow at all? If so, tell us how. In general, try to imagine +what questions a reviewer will ask, and answer those questions in +advance. + Before submitting a patch that adds or modifies a package definition, please run through this check list: -- cgit v1.2.3