apply review suggestions

Signed-off-by: Florent Poinsard <florent.poinsard@outlook.fr>

.github/workflows/static_checks_etc.yml

@@ -220,5 +220,5 @@ jobs:
             exit 0
           fi
           echo 'We wish to maintain a consistent changelog directory, please run `go run ./go/tools/releases/releases.go`, commit and push again.'
-          echo 'Running `go run ./go/tools/releases/releases.go` on this CI test yields with the following changes:'
+          echo 'Running `go run ./go/tools/releases/releases.go` on CI yields the following changes:'
           echo "$output"

go/tools/releases/releases.go

@@ -16,6 +16,19 @@ limitations under the License.
 
 package main
 
+// The changelog directory is composed of a README that lists
+// and links to all major releases of Vitess. It has one
+// sub-directory for each major version. Each sub-directory is
+// composed of another README that also lists and links all the
+// patch releases of this major release. Those sub-directories
+// are composed of one directory per patch release. Finally,
+// the patch release directory contains the old files markdown:
+// summary, release_notes, changelog.
+//
+// This tool is solely responsible for generating the READMEs
+// and making sure they are up-to-date with the list of major
+// and patch releases we have.
+
 import (
 	"log"
 	"os"