diff --git a/scripts/build_icons.js b/scripts/build_icons.js
index 464d00cc..dabe11d0 100644
--- a/scripts/build_icons.js
+++ b/scripts/build_icons.js
@@ -2,6 +2,10 @@ import chalk from 'chalk';
 import fs from 'node:fs';
 import { icon } from '@fortawesome/fontawesome-svg-core';
 
+// This script will update _only_ the FontAwesome icons in `dist/img/*.svg`
+// There are other icons in that folder that are not Font Awesome icons,
+// (e.g. osm, youthmappers, fediverse) - this script won't touch them.
+
 import {
   faAt, faComment, faComments, faKeyboard, faLink, faNewspaper, faUsers
 } from '@fortawesome/free-solid-svg-icons';
@@ -12,6 +16,7 @@ import {
   faSquareThreads, faSquareXTwitter, faSquareYoutube, faTelegram,
 } from '@fortawesome/free-brands-svg-icons';
 
+
 const toBuild = {
   discord: faDiscord,
   discourse: faDiscourse,