diff --git a/Structure-of-the-code.md b/Structure-of-the-code.md
index b918cad..623b386 100644
--- a/Structure-of-the-code.md
+++ b/Structure-of-the-code.md
@@ -13,7 +13,7 @@ The package code is organized in osxphotos per the table below. Most of the file
 |---|---|
 |`__init__.py`|              this is what gets read by "import osxphotos"|
 |`__main__.py`|              the command line interface, what gets executed with python3 -m osxphotos|
-|`_applescript`|             contains a copy of pyapplescript from https://github.com/rdhyee/py-applescript|
+|`_applescript`|             contains a copy of [pyapplescript](https://github.com/rdhyee/py-applescript) used to interact directly with Photos via applescript to force the download of photos from iCloud if needed|
 |`_constants.py`|            constants used by the other modules|
 |`_version.py`|              version string|
 |`albuminfo.py`|             AlbumInfo and FolderInfo classes|
@@ -23,8 +23,8 @@ The package code is organized in osxphotos per the table below. Most of the file
 |`photosdb.py`|              PhotosDB class |
 |`placeinfo.py`|             PlaceInfo class|
 |`template.py`|              constants used by the PhotoInfo.render_template() method|
-|`templates`|                contains mako templates, see https://www.makotemplates.org/|
-|`templates/xmp_sidecar.mako`| |
-|`utils.py`| |
+|`templates`|                contains [mako](https://www.makotemplates.org/) templates|
+|`templates/xmp_sidecar.mako`|mako template used to create [XMP](https://en.wikipedia.org/wiki/Extensible_Metadata_Platform) sidecar files|
+|`utils.py`|.                various utility methods--this file is getting bloated and needs to be refactored|