added pinning explanations

Author: kgraaf

fbfmaproom/environment.yml

@@ -3,15 +3,28 @@ channels:
   - conda-forge
   - defaults
 dependencies:
+
+    # Conda still appears to have issues surrounding Python 3.10
   - python=3.9
   - cftime
   - dash
   - flask
   - numpy
   - opencv
+
+    # Newer versions of Pandas do not appear to work correctly with queuepool.
+    # In particular, how that package forms SQL query objects needs to be updated. 
+    # Hopefully the solution here is to either send Igor a issue or to migrate to
+    # a different connection pooling library
   - pandas=1.3
   - psycopg2
   - rasterio
+
+    # Shapely changed how looping over geometries works in the newer version and
+    # Pingrid relies on the old functionality. It is unclear to me whether using
+    # the .geoms property has the same behavior as the "built in" iterator the
+    # old version had. As we may migrate way from Pingrid and we're not going to
+    # upgrade it right now and possibly waste the work or effort.
   - shapely=1.7
   - xarray
   - yaml