diff --git a/tools/code-tools/asmtools.sh b/tools/code-tools/asmtools.sh
index bcd64b972..5db1e4c47 100755
--- a/tools/code-tools/asmtools.sh
+++ b/tools/code-tools/asmtools.sh
@@ -1,5 +1,12 @@
-
 #!/bin/bash
+
+###################################################################
+# Scrtipt to build asmtools to be reused by jdk testing community #
+# currenlty builds tip of master and tip of at8 branch            #
+# In future, it should clone and build:                           #
+# tip of master, latest release in master, and tip of at7 branch  #
+###################################################################
+
 # shellcheck disable=SC2035,SC2155
 set -euo pipefail
 WORKSPACE=$PWD
diff --git a/tools/code-tools/jcstress.sh b/tools/code-tools/jcstress.sh
index e39f60b76..a12c6bd03 100755
--- a/tools/code-tools/jcstress.sh
+++ b/tools/code-tools/jcstress.sh
@@ -1,4 +1,10 @@
 #!/bin/bash
+
+###################################################################
+# Scrtipt to build jcstress to be reused by jdk testing community #
+# currenlty builds tip and latest released version                #
+###################################################################
+
 # shellcheck disable=SC2035,SC2155
 set -euo pipefail
 WORKSPACE=$PWD
diff --git a/tools/code-tools/jtreg.sh b/tools/code-tools/jtreg.sh
index 45cbdcc71..807f0703d 100755
--- a/tools/code-tools/jtreg.sh
+++ b/tools/code-tools/jtreg.sh
@@ -1,4 +1,10 @@
 #!/bin/bash
+
+###################################################################
+# Scrtipt to build jtreg test suite harness                       #
+# currenlty builds tip, 5.1, 6, 6.1, 7, 7.1, 7.2                  #
+###################################################################
+
 # shellcheck disable=SC2035,SC2116
 
 set -eu