[Outreachy] [PATCH 0/1]
cover [Outreachy] [PATCH 0/1]
*** BLURB HERE ***
Caleb Tillman (1):
Microproject - Use debug-friendly test_path_is_* functions.
t/t0000-basic.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
Signature · 3 lines
2.25.1 Microproject for Outreachy. Replace test -f with test_path_is_file in t/t0000-basic.sh.
PATCH 1/1 Microproject - Use debug-friendly test_path_is_* functions.
t0000-basic.sh - Replace an instance of test -f with test_path_is_file.
--- t/t0000-basic.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
t/t0000-basic.sh +1 -1
@@ -1191,7 +1191,7 @@ test_expect_success 'writing this tree with --missing-ok' ' test_expect_success 'git read-tree followed by write-tree should be idempotent' ' rm -f .git/index && git read-tree $tree && - test -f .git/index && + test_path_is_file .git/index && newtree=$(git write-tree) && test "$newtree" = "$tree" '
Signature · 1 line
2.25.1
Re: [PATCH 1/1] Microproject - Use debug-friendly test_path_is_* functions.
Quoted 2 lines · Caleb Tillman
t0000-basic.sh- Replace an instance of test -f withtest_path_is_file.
This line seems redundant with the subject.
We suggest that all the messages sent by Outreachy applicants or interns have "[Outreachy]" at the beginning of their subject. This way we can identify these emails more easily and prioritize them. Also using "[...]" ensures that "Outreachy" doesn't appear in the commits when the patches are applied.
For Outreachy patches related to a test script, we suggest a subject like:
[Outreachy][PATCH X/Y] tZZZZ: do something
where X, Y and ZZZZ are numbers and tZZZZ is the identifier of the test script.
So in this case the subject should be something like:
[Outreachy][PATCH 1/1] t0000: replace an instance of test -f with test_path_is_file
Note that there is no "Microproject" in the subject and that there is no uppercase letter used after "PATCH".
The body of the message should explain the reason or the goal of the patch. Here the reason is that test_path_is_file provides an (hopefully helpful) error message when it fails, so it should make the reason for a test failure easier to diagnose.
Quoted 2 lines
Signed-off-by Caleb Tillman <[email protected]>---
Here, after the line with "---" and before the stats below, you can add comments that will not appear in the commit message when the patch will be applied. For example here you can say that the patch is your microproject.
If you really want to make it more prominent, another option is to use [Outreachy-Microproject] in the subject instead of [Outreachy] but it makes the subject line longer for information that we are anyway not likely to miss.
Quoted 8 lines
t/t0000-basic.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)t/t0000-basic.sh +0
-0
t/t0000-basic.sh test_expect_success 'writing this tree with --missing-ok' ' · line 1197
Quoted 8 lines
t/t0000-basic.sh +1
-1@@ -1191,7 +1191,7 @@ test_expect_success 'writing this tree with --missing-ok' ' test_expect_success 'git read-tree followed by write-tree should be idempotent' ' rm -f .git/index && git read-tree $tree && - test -f .git/index && + test_path_is_file .git/index && newtree=$(git write-tree) && test "$newtree" = "$tree" '
This looks good to me.
Thanks!
Quoted 2 lines · Caleb Tillman
*** BLURB HERE ***
Cover letters like this are about giving context for a series of patches. As there is only one patch (1/1) in the series, the context in the patch itself should suffice, so there is no real need for a cover letter like this if there is only one patch.
When there is a real need for a cover letter though, the title of the cover letter should explain what the patch series is about and "*** BLURB HERE ***" in the body of the cover letter should be replaced by text that explains the context and the reason for the patch series.
Thanks!