On Wed, Apr 12, 2023 at 1:05 PM Glen Choo via GitGitGadget <gitgitgadget@xxxxxxxxx> wrote: > > Here's the followup to the discussion in [1]. Sorry for the delay. > > I've tried to incorporate most of the responses from that thread as well as > suggest some guidelines that I think would make the authoring + reviewing > process smoother. I've opted for stronger wording to make the guidelines > easier to follow, but I don't feel strongly about the specifics. > > [1] > https://lore.kernel.org/git/kl6l7cuycd3n.fsf@xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx > > Glen Choo (2): > cocci: add headings to and reword README > cocci: codify authoring and reviewing practices > > contrib/coccinelle/README | 33 +++++++++++++++++++++++++++++---- > 1 file changed, 29 insertions(+), 4 deletions(-) > > > base-commit: f285f68a132109c234d93490671c00218066ace9 > Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1495%2Fchooglen%2Fpush-lsxuouxyokwo-v1 > Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1495/chooglen/push-lsxuouxyokwo-v1 > Pull-Request: https://github.com/git/git/pull/1495 > -- > gitgitgadget I read through both patches, and I generally like them. I'm a little unsure on the "To give a Reviewed-by" bit of patch 2. For example, it could be possible that .cocci changes might apply a few different kinds of changes, and say only 2 of the 3 are reflected in the current tree, and those 2 types are handled correctly but the third type of change is buggy. The .cocci files would then be a bug waiting to happen. Maybe that's just a risk we take and it's okay for folks to give a Reviewed-by even being unfamiliar with cocci. Maybe the wording should instead be "It's okay to give a Reviewed-by: on a series that also contains cocci changes when you are unfamiliar with coccinelle; just state that your Reviewed-by is limited to the other bits". Or maybe the instructions should just be to give an Acked-by. You should probably have someone familiar enough with coccinelle that they know what is worth worrying about weigh in on that aspect. But you can have my Acked-by on the other bits. :-)