diff --git a/omegat_tools/config/omegat-tools.conf b/omegat_tools/config/omegat-tools.conf
index a0a6727..cb0c71a 100644
--- a/omegat_tools/config/omegat-tools.conf
+++ b/omegat_tools/config/omegat-tools.conf
@@ -1,8 +1,21 @@
+# Configuration file for the omegat-tools scripts
+# Lines starting with # or ; are considered comments and ignored by the script.
+
 [Paths]
+# Enter the full path to the directory containing the target OmegaT projects,
+# as per the examples below.
+# Use forward slashes to separate directories, even on Windows.
+# If the "glossaries" dictionary is in a subdirectory of the "projects"
+# directory, you can use %(projects)s as shown below as a stand-in for the full
+# project path. 
+
 projects = /Documents/OmegaT_Projects
 glossaries = %(projects)s/glossaries
 
 [Files]
+# The files needed to collect and copy OmegaT project data,
+# and the extensions that identify potential glossary files.
+
 project_file = omegat.project
 main_memory = omegat/project_save.tmx
 main_glossary = glossary/glossary.txt
@@ -10,8 +23,9 @@ glossary_files = *.txt, *.utf8, *.csv, *.tsv
 
 [Translators]
 # List the username matching the 'creationid' or 'changeid' fields of 
-# the TMX file, and a pseudo targetlanguage code such as EN-AA.
-# The code following the hyphen must consist of two captial letters.
+# the TMX file, and a pseudo target language code such as EN-AA.
+# The code following the hyphen must consist of two capital letters.
 
-# Example:
+# Example (replace with your own list of translator user names,
+# and assign a unique code to each one):
 junior_translator = EN-JT