Reduce visual noise in report

README.md

@@ -94,9 +94,7 @@ jobs:
 
 It will post a comment on PRs to notify subscribers:
 
-> # CODENOTIFY report
->
-> a1b2c3...d4e5f6
+> Notifying subscribers in [CODENOTIFY](https://github.com/sourcegraph/codenotify) files for diff a1b2c3...d4e5f6.
 >
 > | Notify | File(s)              |
 > | ------ | -------------------- |

main.go

@@ -351,7 +351,7 @@ type options struct {
 	print   func(notifs map[string][]string) error
 }
 
-const markdownCommentTitle = "# CODENOTIFY report\n\n"
+const markdownCommentTitle = "<!-- codenotify report -->\n"
 
 func (o *options) writeNotifications(w io.Writer, notifs map[string][]string) error {
 	subs := []string{}
@@ -374,7 +374,7 @@ func (o *options) writeNotifications(w io.Writer, notifs map[string][]string) er
 		return nil
 	case "markdown":
 		fmt.Fprint(w, markdownCommentTitle)
-		fmt.Fprintf(w, "%s...%s\n\n", o.baseRef, o.headRef)
+		fmt.Fprintf(w, "Notifying subscribers in [CODENOTIFY](https://github.com/sourcegraph/codenotify) files for diff %s...%s.\n\n", o.baseRef, o.headRef)
 		if len(notifs) == 0 {
 			fmt.Fprintln(w, "No notifications.")
 		} else {

main_test.go

@@ -145,9 +145,8 @@ func TestWriteNotifications(t *testing.T) {
 			},
 			notifs: nil,
 			output: []string{
-				"# CODENOTIFY report",
-				"",
-				"a...b",
+				"<!-- codenotify report -->",
+				"Notifying subscribers in [CODENOTIFY](https://github.com/sourcegraph/codenotify) files for diff a...b.",
 				"",
 				"No notifications.",
 			},
@@ -177,9 +176,8 @@ func TestWriteNotifications(t *testing.T) {
 				"@js": {"file.js", "dir/file.js"},
 			},
 			output: []string{
-				"# CODENOTIFY report",
-				"",
-				"a...b",
+				"<!-- codenotify report -->",
+				"Notifying subscribers in [CODENOTIFY](https://github.com/sourcegraph/codenotify) files for diff a...b.",
 				"",
 				"| Notify | File(s) |",
 				"|-|-|",