diff --git a/collate.py b/collate.py
index d789a6c5..3ab5224b 100755
--- a/collate.py
+++ b/collate.py
@@ -5,6 +5,11 @@ Collate lists of seen commodities, modules and ships from dumps of the Companion
 Note that currently this will only work with the output files created if you
 run the main program from a working directory that has a `dump/` directory,
 which causes a file to be written per CAPI query.
+
+This script also utilise the file outfitting.csv.  As it both reads it in *and*
+writes out a new copy a local copy, in the root of the project structure, is
+used for this purpose.  If you want to utilise the FDevIDs/ version of the
+file, copy it over the local one.
 """
 
 import csv
diff --git a/coriolis.py b/coriolis.py
index 5ce76a29..0afb16e5 100755
--- a/coriolis.py
+++ b/coriolis.py
@@ -1,5 +1,12 @@
 #!/usr/bin/env python3
-"""Build ship and module databases from https://github.com/EDCD/coriolis-data/ ."""
+"""
+Build ship and module databases from https://github.com/EDCD/coriolis-data/ .
+
+This script also utilise the file outfitting.csv.   Due to how collate.py
+both reads and writes to this file a local copy is used, in the root of the
+project structure, is used for this purpose.  If you want to utilise the
+FDevIDs/ version of the file, copy it over the local one.
+"""
 
 
 import csv