diff --git a/src/containers/gui.jsx b/src/containers/gui.jsx
index a02609d7b8fa4e59dd5854098d54be1cad9fa8f6..be68e3dd6f97490faefbc9dbc9049808e7182ead 100644
--- a/src/containers/gui.jsx
+++ b/src/containers/gui.jsx
@@ -124,6 +124,9 @@ const ConnectedGUI = connect(
     mapDispatchToProps,
 )(GUI);
 
+// note that redux's 'compose' function is just being used as a general utility to make
+// the hierarchy of HOC constructor calls clearer here; it has nothing to do with redux's
+// ability to compose reducers.
 const WrappedGui = compose(
     ErrorBoundaryHOC('Top Level App'),
     ProjectFetcherHOC,
diff --git a/src/playground/player.jsx b/src/playground/player.jsx
index 6fdd230efcdbea0309efb9d73a684adc1366311d..d47795c2ef9ba114373de506c4ceb0e217bf62d3 100644
--- a/src/playground/player.jsx
+++ b/src/playground/player.jsx
@@ -50,7 +50,14 @@ const mapDispatchToProps = dispatch => ({
     onSeeInside: () => dispatch(setPlayer(false))
 });
 
-const ConnectedPlayer = connect(mapStateToProps, mapDispatchToProps)(Player);
+const ConnectedPlayer = connect(
+    mapStateToProps,
+    mapDispatchToProps
+)(Player);
+
+// note that redux's 'compose' function is just being used as a general utility to make
+// the hierarchy of HOC constructor calls clearer here; it has nothing to do with redux's
+// ability to compose reducers.
 const WrappedPlayer = compose(
     HashParserHOC,
     AppStateHOC,
diff --git a/src/playground/render-gui.jsx b/src/playground/render-gui.jsx
index 1bb4ead50af23e422ff276e0491287fef68ffd33..a7df02ca2ae6e2da7c9e1db61ce794f0ad42dad7 100644
--- a/src/playground/render-gui.jsx
+++ b/src/playground/render-gui.jsx
@@ -15,6 +15,10 @@ import ProjectMetaDataHOC from '../lib/project-metadata-hoc.jsx';
  */
 export default appTarget => {
     GUI.setAppElement(appTarget);
+
+    // note that redux's 'compose' function is just being used as a general utility to make
+    // the hierarchy of HOC constructor calls clearer here; it has nothing to do with redux's
+    // ability to compose reducers.
     const WrappedGui = compose(
         AppStateHOC,
         HashParserHOC, // NOTE: IMPORTANT: ok that i've reordered this?