3 files changed, 17 insertions, 2 deletions
diff --git a/bin/fetch-comments b/bin/fetch-comments
index ef099fcc9..a276433e4 100755
--- a/bin/fetch-comments
+++ b/bin/fetch-comments
@@ -1,4 +1,8 @@
 #!/usr/bin/env perl
+#
+# This script utilises the Open311 extension explained at
+# https://github.com/mysociety/FixMyStreet/wiki/Open311-FMS---Proposed-differences-to-Open311
+# to fetch updates on service requests.
 
 use strict;
 use warnings;
diff --git a/bin/fetch-comments-24hs b/bin/fetch-comments-24hs
index b84f09ba7..602383d40 100644
--- a/bin/fetch-comments-24hs
+++ b/bin/fetch-comments-24hs
@@ -1,4 +1,9 @@
 #!/usr/bin/env perl
+#
+# This script utilises the Open311 extension explained at
+# https://github.com/mysociety/FixMyStreet/wiki/Open311-FMS---Proposed-differences-to-Open311
+# to fetch updates on service requests from the past 24 hours, to check none
+# were missed.
 
 use strict;
 use warnings;
diff --git a/bin/open311-update-reports b/bin/open311-update-reports
index e7ff34273..3b77fef89 100644
--- a/bin/open311-update-reports
+++ b/bin/open311-update-reports
@@ -1,4 +1,10 @@
 #!/usr/bin/perl
+#
+# This script utilises the standard Open311 way of getting updates on reports
+# (by fetching all reports for a body and looking for updates). If possible,
+# please use the extension explained at
+# https://github.com/mysociety/FixMyStreet/wiki/Open311-FMS---Proposed-differences-to-Open311
+# and the fetch-comments/send-comments scripts.
 
 use strict;
 use warnings;
@@ -13,9 +19,9 @@ my $system_user = FixMyStreet::App->model('DB::User')->find_or_create(
     }
 );
 
-my $council_list = FixMyStreet::App->model('DB::Body');
+my $body_list = FixMyStreet::App->model('DB::Body');
 
 my $update = Open311::GetUpdates->new(
-    council_list => $council_list,
+    body_list => $body_list,
     system_user  => $system_user
 )->get_updates;