Add comments to the locale strings

locales/en-US/editor.properties

@@ -4,7 +4,7 @@
 
 # General File I/O Error strings
 
-# Error message prefix that will look like: "error my message"
+# Error message prefix that will look like: "(error my message)"
 GENERIC_ERROR=(error {0})
 NOT_FOUND_ERR=The file/directory could not be found.
 NOT_READABLE_ERR=The file/directory could not be read.
@@ -21,21 +21,34 @@ DIRECTORY_NAME=Directory Name
 
 # File Open/Save Error strings
 
+# The {0} here will be replaced by an actual error message
 OPEN_DIALOG_ERROR=An error occurred when showing the open file dialog. (error {0})
+# {0} will be replaced with a filename and {1} will be replaced by an error message
 READ_DIRECTORY_ENTRIES_ERROR=An error occurred when reading the contents of the directory <span class='dialog-filename'>{0}</span>. (error {1})
 ERROR_OPENING_FILE_TITLE=Error Opening File
+# {0} will be replaced with a filename and {1} will be replaced by an error message
 ERROR_OPENING_FILE=An error occurred when trying to open the file <span class='dialog-filename'>{0}</span>. {1}
 ERROR_OPENING_FILES=An error occurred when trying to open the following files:
 ERROR_SAVING_FILE_TITLE=Error Saving File
+# {0} will be replaced with a filename and {1} will be replaced by an error message
 ERROR_SAVING_FILE=An error occurred when trying to save the file <span class='dialog-filename'>{0}</span>. {1}
+# {0} will be replaced with the localized word "file" or "directory"
 ERROR_RENAMING_FILE_TITLE=Error Renaming {0}
+# {0} will be replaced with a filename and {1} will be replaced by an error message and {2} will be replaced by the localized word "file" or "directory"
 ERROR_RENAMING_FILE=An error occurred when trying to rename the {2} <span class='dialog-filename'>{0}</span>. {1}
+# {0} will be replaced with the localized word "file" or "directory"
 ERROR_DELETING_FILE_TITLE=Error Deleting {0}
+# {0} will be replaced with a filename and {1} will be replaced by an error message and {2} will be replaced by the localized word "file" or "directory"
 ERROR_DELETING_FILE=An error occurred when trying to delete the {2} <span class='dialog-filename'>{0}</span>. {1}
+# {0} will be replaced with the localized word "file" or "directory"
 INVALID_FILENAME_TITLE=Invalid {0}
+# {0} will be replaced with the localized word "Directory names" or "File names" and {1} will be replaced with an error message
 INVALID_FILENAME_MESSAGE={0} cannot use any system reserved words, end with dots (.) or use any of the following characters: <code class='emphasized'>{1}</code>
+# {0} will be replaced with a filename
 ENTRY_WITH_SAME_NAME_EXISTS=A file or directory with the name <span class='dialog-filename'>{0}</span> already exists.
+# {0} will be replaced with the localized word "file" or "directory"
 ERROR_CREATING_FILE_TITLE=Error Creating {0}
+# {0} will be replaced with the localized word "file" or "directory" and {1} will be replaced with a file or directory name
 ERROR_CREATING_FILE=An error occurred when trying to create the {0} <span class='dialog-filename'>{1}</span>. {2}
 
 # Project max files Error strings
@@ -45,8 +58,11 @@ ERROR_MAX_FILES_TITLE=Error Indexing Files
 # Saving Errors
 
 EXT_MODIFIED_TITLE=External Changes
+# {0} will be replaced by a filename and {APP_NAME} will be replaced with the word "Brackets"
 EXT_MODIFIED_WARNING=<span class='dialog-filename'>{0}</span> has been modified on disk outside of {APP_NAME}.<br /><br />Do you want to save the file and overwrite those changes?
+# {0} will be replaced by a filename and {APP_NAME} will be replaced with the word "Brackets"
 EXT_MODIFIED_MESSAGE=<span class='dialog-filename'>{0}</span> has been modified on disk outside of {APP_NAME}, but also has unsaved changes in {APP_NAME}.<br /><br />Which version do you want to keep?
+# {0} will be replaced by a filename and {APP_NAME} will be replaced with the word "Brackets"
 EXT_DELETED_MESSAGE=<span class='dialog-filename'>{0}</span> has been deleted on disk outside of {APP_NAME}, but has unsaved changes in {APP_NAME}.<br /><br />Do you want to keep your changes?
 
 
@@ -57,6 +73,7 @@ EXT_DELETED_MESSAGE=<span class='dialog-filename'>{0}</span> has been deleted on
 # Delete
 
 CONFIRM_FOLDER_DELETE_TITLE=Confirm Delete
+# {0} will be replaced by a directory name
 CONFIRM_FOLDER_DELETE=Are you sure you want to delete the folder <span class='dialog-filename'>{0}</span>?
 FILE_DELETED_TITLE=File Deleted
 
@@ -106,7 +123,9 @@ DND_ERROR_UNZIP=unable to unzip file
 DND_ERROR_UNTAR=unable to untar file
 DND_SUCCESS_UNZIP_TITLE=Unzip Completed Successfully
 DND_SUCCESS_UNTAR_TITLE=Untar Completed Successfully
+# {0} will be replaced by a zip filename
 DND_SUCCESS_UNZIP=Successfully unzipped <b>{0}</b>.
+# {0} will be replaced by a tar filename
 DND_SUCCESS_UNTAR=Successfully untarred <b>{0}</b>.
 
 ################
@@ -120,7 +139,9 @@ COLOR_EDITOR_ORIGINAL_COLOR_SWATCH_TIP=Original Color
 COLOR_EDITOR_RGBA_BUTTON_TIP=RGBa Format
 COLOR_EDITOR_HEX_BUTTON_TIP=Hex Format
 COLOR_EDITOR_HSLA_BUTTON_TIP=HSLa Format
+# {0} will be replaced by a color name (like "blue") and {1} will be replaced by a number
 COLOR_EDITOR_USED_COLOR_TIP_SINGULAR={0} (Used {1} time)
+# {0} will be replaced by a color name (like "blue") and {1} will be replaced by a number
 COLOR_EDITOR_USED_COLOR_TIP_PLURAL={0} (Used {1} times)
 
 # extensions/default/JavaScriptCodeHints