diff --git a/README.md b/README.md
index 80b17d85..0f20beb7 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ composer require sokil/php-isocodes
 
 ## Locale configuration
 
-Before using IsoCodes database you need to setup valid locale to get transtions worked:
+Before using IsoCodes database you need to setup valid locale to get translations worked:
 
 ```php
 <?php
@@ -97,8 +97,8 @@ Generation complete.
 Database and related gettext files located inside this repo in `databases` and `messages` directories. 
 This data periodically updated with package version increment.
 
-If you want to update database more often, use script `update_db.sh`. 
-Call this script by cron, during deploy process or when build your docker image. 
+If you want to update database more often, use script `./bin/update_iso_codes_db.sh`. 
+Call this script by cron, during deploy process or when build your docker image.
 
 ```
 /path/to/project/vendor/sokil/php-isocodes/bin/update_iso_codes_db.sh /var/isocodes
diff --git a/bin/release.sh b/bin/release.sh
index e0939dff..a1dbf93b 100755
--- a/bin/release.sh
+++ b/bin/release.sh
@@ -1,5 +1,12 @@
 #!/usr/bin/env bash
 
+#############################################
+#                                           #
+#    Update internal database for           #
+#    publishing to GitHub                   #
+#                                           #
+#############################################
+
 CURRENT_DIR=$(dirname $(readlink -f $0))
 PROJECT_DIR=$CURRENT_DIR/..
 PKG_ISOCODES_DIR="${PROJECT_DIR}/build/iso-codes"
diff --git a/bin/update_iso_codes_db.sh b/bin/update_iso_codes_db.sh
index 89ed97af..cba7063c 100755
--- a/bin/update_iso_codes_db.sh
+++ b/bin/update_iso_codes_db.sh
@@ -1,5 +1,12 @@
 #!/usr/bin/env bash
 
+#########################################################
+#                                                       #
+#    Update database on specified place                 #
+#    Usage: ./bin/update_iso_codes_db.sh /var/isocodes  #
+#                                                       #
+#########################################################
+
 CURRENT_DIR=$(dirname $(readlink -f $0))
 PROJECT_DIR=$CURRENT_DIR/..
 PKG_ISOCODES_DIR="${PROJECT_DIR}/build/iso-codes"