updating README.md and the enrichers and ice_scrapers README, also some typos on US Marshals Service

Author: HongPong

README.md

@@ -110,12 +110,10 @@ Another command for installing mise in your session can also work (in bash):
 in hopes of finding similarly named pages but this is too aggressive, and it veers way off. (That is, it's looking for places
 that have simpler names, like the county name instead of `county + detention center`). Use the debug mode to see what
 it is doing.
-* ICE scraping is not robustly tested. The image URL extraction needs some work. (should be able to get the detention center image URLs.)
 * The user-agent for running ice.gov scrape web requests calls itself `'User-Agent': 'ICE-Facilities-Research/1.0 (Educational Research Purpose)'`.
 You can change this in `utils.py`.
 * It tells some pretty inaccurate percentages in the final summary - a lot of false positives, the Wikipedia debug percent
 seems wrong.
-* The remote query rate limiting is (I think) done in series but would go faster with parallel/async processing.
 * This is only targeted at English (EN) Wikipedia currently, but  multi-lingual page checks would help a wider audience.
 
 ## Contributing & Code Standards
@@ -128,6 +126,9 @@ Pull requests and reviews are welcome on the main repo. For checking type safety
 uv run mypy .
 ```
 
+Please see the [ice_scrapers README.md](ice_scrapers/README.md) and [enrichers README.md](enrichers/README.md)
+for more details about the facilities scrapers and how to create new enrichers for new data sources.
+
 ## Credit
 
 Original version by Dan Feidt ([@HongPong](https://github.com/HongPong)), with assistance from various AI gizmos. (My

enrichers/README.md

@@ -4,7 +4,8 @@ These functions let us collect data about facilities from additional sources.
 
 ## Enrichment class
 
-The base class we can build enrichment tools from. Largely ensures some consistent in functionality between enrichment tools.
+The base class we can build enrichment tools from. Largely ensures some consistent
+in functionality between enrichment tools.
 
 ### Available functions
 

ice_scrapers/README.md

@@ -1,25 +1,38 @@
 # ICE Facility scrapers
 
-These files maintain the code to collect (and collate) ICE facility data from a number of sources.
+----
+
+These files maintain the code to collect (and collate) ICE facility data
+from a number of sources.
 
 ## utils.py
 
-Contains most of our collating functions and shared functions that scrapers may need.
+Contains most of our collating functions and shared functions that scrapers
+may need.
 
 ## __init__.py
 
-Contains some static objects and import declarations (so we can `from ice_scrapers import` successfully)...
+Contains some static objects and import declarations (so we can `from ice_scrapers import`
+successfully)...
 
 ## spreadsheet_load.py
 
-ICE is required by law to produce regular custody data. We can pull that data from here `https://www.ice.gov/detain/detention-management`. Because this spreadsheet is more "complete" than other sources we've found, we use it as our base scrape.
+ICE is required by law to produce regular custody data. We can pull that data from
+here `https://www.ice.gov/detain/detention-management`. Because this spreadsheet is
+more "complete" than other sources we've found, we use it as our base scrape.
 
 ## facilities_scraper.py
 
-Pulls information about ICE detention facilities from `https://www.ice.gov/detention-facilities`. This can add additional (or corrected) data about facilities locations, contact information, and provides facility images.
+Pulls information about ICE detention facilities from
+`https://www.ice.gov/detention-facilities`. This can add additional (or corrected)
+data about facilities locations, contact information, and provides facility images.
 
 ## field_offices.py
 
-Collects additional data about ICE/DHS field offices from `https://www.ice.gov/contact/field-offices`. Largely basic areas of responsibility and contact info for the field office.
+Collects additional data about ICE/DHS field offices from
+`https://www.ice.gov/contact/field-offices`. Largely basic areas of responsibility
+and contact info for the field office.
 
-> The field-offices page shows information about a number of different offices. As we are largely focused on detention, ERO (Eforcement and Removal Operations) centers are the most interesting.
+> The field-offices page shows information about a number of different offices. As we
+> are largely focused on detention, ERO (Enforcement and Removal Operations) centers
+> are the most interesting.

ice_scrapers/__init__.py

@@ -44,11 +44,11 @@
     },
     "DIGSA": {
         "expanded_name": "Dedicated Intergovernmental Service Agreement",
-        "description": "A publicly-owned facility operated by state/local government(s), or private contractors, in which ICE contracts to use all bed space via a Dedicated Intergovernmental Service Agreement; or facilities used by ICE pursuant to Inter-governmental Service Agreements, which house only ICE detainees – typically these are operated by private contractors pursuant to their agreements with local governments.",
+        "description": "A publicly-owned facility operated by state/local government(s), or private contractors, in which ICE contracts to use all bed space via a Dedicated Intergovernmental Service Agreement; or facilities used by ICE pursuant to Intergovernmental Service Agreements, which house only ICE detainees – typically these are operated by private contractors pursuant to their agreements with local governments.",
     },
     "IGSA": {
         "expanded_name": "Intergovernmental Service Agreement",
-        "description": "A publicly-owned facility operated by state/local government(s), or private contractors, in which ICE contracts for bed space via an Intergovernmental Service Agreement; or local jails used by ICE pursuant to Inter-governmental Service Agreements, which house both ICE and non-ICE detainees, typically county prisoners awaiting trial or serving short sentences, but sometimes also USMS prisoners.",
+        "description": "A publicly-owned facility operated by state/local government(s), or private contractors, in which ICE contracts for bed space via an Intergovernmental Service Agreement; or local jails used by ICE pursuant to Intergovernmental Service Agreements, which house both ICE and non-ICE detainees, typically county prisoners awaiting trial or serving short sentences, but sometimes also USMS prisoners.",
     },
     "SPC": {
         "expanded_name": "Service Processing Center",
@@ -60,15 +60,15 @@
     },
     # two keys for the same thing as it isn't consistently defined
     "USMSIGA": {
-        "expanded_name": "United States Marshal Service Intergovernmental Agreement",
-        "description": "A USMS Intergovernmental Agreement in which ICE agrees to utilize an already established US Marshal Service contract.",
+        "expanded_name": "United States Marshals Service Intergovernmental Agreement",
+        "description": "A USMS Intergovernmental Agreement in which ICE agrees to utilize an already established US Marshals Service contract.",
     },
     "USMS IGA": {
-        "expanded_name": "United States Marshal Service Intergovernmental Agreement",
-        "description": "A USMS Intergovernmental Agreement in which ICE agrees to utilize an already established US Marshal Service contract.",
+        "expanded_name": "United States Marshals Service Intergovernmental Agreement",
+        "description": "A USMS Intergovernmental Agreement in which ICE agrees to utilize an already established US Marshals Service contract.",
     },
     "USMS CDF": {
-        "expanded_name": "United States Marshal Service Contract Detention Facility",
+        "expanded_name": "United States Marshals Service Contract Detention Facility",
         "description": "Name derived from listing at https://www.vera.org/ice-detention-trends",
     },
     "CDF": {