diff --git a/scripts/update.lua b/scripts/update.lua
index 8784c78..ba1f8d6 100755
--- a/scripts/update.lua
+++ b/scripts/update.lua
@@ -1,4 +1,5 @@
 #!/usr/bin/env -S nvim -l
+-- this script relies on the parser configuration used by the nvim-treesitter repository (https://github.com/nvim-treesitter/nvim-treesitter) to update the various parsers built in py-tree-sitter-languages
 -- called by scripts/update.sh
 -- refer .github/workflows/update.yml
 ---@diagnostic disable: undefined-global
diff --git a/scripts/update.sh b/scripts/update.sh
index a4391fb..6fe18fe 100755
--- a/scripts/update.sh
+++ b/scripts/update.sh
@@ -2,6 +2,7 @@
 set -e
 cd "$(dirname "$(readlink -f "$0")")/.."
 
+# Sync the parsers and their versions with those used by nvim-treesitter
 scripts/update.lua
 cp nvim-treesitter/lockfile.json .
 git add parsers.json lockfile.json