Skip to content

A platform for community discussion. Free, open, simple.

DEV: Remove unused developer docs images and check for them in CI (#44426)

Kris2dd108e07b0e
diff --git a/.github/workflows/developer-docs-lint.yml b/.github/workflows/developer-docs-lint.yml
index f7f69ab82c0..8889f2d30ee 100644
--- a/.github/workflows/developer-docs-lint.yml
+++ b/.github/workflows/developer-docs-lint.yml
@@ -45,3 +45,24 @@ jobs:
- name: Lint
run: pnpm lint
+
+ unused-assets:
+ if: github.event_name == 'pull_request' || github.repository != 'discourse/discourse-private-mirror'
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+
+ defaults:
+ run:
+ working-directory: docs/developer-guides
+
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 1
+
+ - uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: "3.3"
+
+ - name: Check for unused assets
+ run: ./check_unused_assets
diff --git a/docs/developer-guides/README.md b/docs/developer-guides/README.md
index 7a79ebfd3dd..cc2a5d3dbe9 100644
--- a/docs/developer-guides/README.md
+++ b/docs/developer-guides/README.md
@@ -70,6 +70,8 @@ Images (e.g. screenshots) for docs can be stored in the `/assets` directory. To
The sync tool will automatically upload the images to Discourse, and replace the path with a discourse-specific `upload://` path. A mapping of repo-path to discourse-path will be persisted in an HTML comment at the end of the doc's topic.
+When a doc stops using an image, delete it from `/assets`. CI runs `./check_unused_assets` to catch any that are left behind.
+
Avoid hotlinking images from other sources. If you do, Discourse may download them and update the topic content. This will cause the docs sync tool to detect a diff, and update the topic unnecessarily.
## Links between docs
diff --git a/docs/developer-guides/assets/api-documentation-1.gif b/docs/developer-guides/assets/api-documentation-1.gif
deleted file mode 100644
index fb983a08232..00000000000
Binary files a/docs/developer-guides/assets/api-documentation-1.gif and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-1.png b/docs/developer-guides/assets/api-examples-1.png
deleted file mode 100644
index 709cd336255..00000000000
Binary files a/docs/developer-guides/assets/api-examples-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-2.png b/docs/developer-guides/assets/api-examples-2.png
deleted file mode 100644
index 68087d105f1..00000000000
Binary files a/docs/developer-guides/assets/api-examples-2.png and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-3.png b/docs/developer-guides/assets/api-examples-3.png
deleted file mode 100644
index 88926a268d3..00000000000
Binary files a/docs/developer-guides/assets/api-examples-3.png and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-4.png b/docs/developer-guides/assets/api-examples-4.png
deleted file mode 100644
index bf8dd02722a..00000000000
Binary files a/docs/developer-guides/assets/api-examples-4.png and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-5.png b/docs/developer-guides/assets/api-examples-5.png
deleted file mode 100644
index 3265d9553be..00000000000
Binary files a/docs/developer-guides/assets/api-examples-5.png and /dev/null differ
diff --git a/docs/developer-guides/assets/api-examples-6.png b/docs/developer-guides/assets/api-examples-6.png
deleted file mode 100644
index ccb233a90a7..00000000000
Binary files a/docs/developer-guides/assets/api-examples-6.png and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-1.jpeg b/docs/developer-guides/assets/beginners-guide-1.jpeg
deleted file mode 100644
index 64e20db9090..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-1.jpeg and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-10.PNG b/docs/developer-guides/assets/beginners-guide-10.PNG
deleted file mode 100644
index 97362134368..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-10.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-11.PNG b/docs/developer-guides/assets/beginners-guide-11.PNG
deleted file mode 100644
index 952e7dd093e..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-11.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-13.PNG b/docs/developer-guides/assets/beginners-guide-13.PNG
deleted file mode 100644
index b8f7d04b0a8..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-13.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-14.PNG b/docs/developer-guides/assets/beginners-guide-14.PNG
deleted file mode 100644
index 805d0729f7e..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-14.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-15.jpg b/docs/developer-guides/assets/beginners-guide-15.jpg
deleted file mode 100644
index 3682b4540c8..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-15.jpg and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-16.PNG b/docs/developer-guides/assets/beginners-guide-16.PNG
deleted file mode 100644
index a64810930f9..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-16.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-17.PNG b/docs/developer-guides/assets/beginners-guide-17.PNG
deleted file mode 100644
index 97362134368..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-17.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-18.PNG b/docs/developer-guides/assets/beginners-guide-18.PNG
deleted file mode 100644
index 4b7c7291280..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-18.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-19.PNG b/docs/developer-guides/assets/beginners-guide-19.PNG
deleted file mode 100644
index 934feddd3f6..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-19.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-2.jpeg b/docs/developer-guides/assets/beginners-guide-2.jpeg
deleted file mode 100644
index 21b55ee05f8..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-2.jpeg and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-20.PNG b/docs/developer-guides/assets/beginners-guide-20.PNG
deleted file mode 100644
index 42b737d5650..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-20.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-21.PNG b/docs/developer-guides/assets/beginners-guide-21.PNG
deleted file mode 100644
index 0260e9cf070..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-21.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-22.PNG b/docs/developer-guides/assets/beginners-guide-22.PNG
deleted file mode 100644
index 805a27e0244..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-22.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-23.PNG b/docs/developer-guides/assets/beginners-guide-23.PNG
deleted file mode 100644
index 1a41cd9ab9c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-23.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-24.PNG b/docs/developer-guides/assets/beginners-guide-24.PNG
deleted file mode 100644
index 7753853308e..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-24.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-25.PNG b/docs/developer-guides/assets/beginners-guide-25.PNG
deleted file mode 100644
index 827eab1f20c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-25.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-26.PNG b/docs/developer-guides/assets/beginners-guide-26.PNG
deleted file mode 100644
index ca43bd7d5e2..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-26.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-27.PNG b/docs/developer-guides/assets/beginners-guide-27.PNG
deleted file mode 100644
index 478508a7031..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-27.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-28.PNG b/docs/developer-guides/assets/beginners-guide-28.PNG
deleted file mode 100644
index 9e8a50936b7..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-28.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-29.PNG b/docs/developer-guides/assets/beginners-guide-29.PNG
deleted file mode 100644
index 5a13de291ee..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-29.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-3.jpeg b/docs/developer-guides/assets/beginners-guide-3.jpeg
deleted file mode 100644
index 514ce1e4544..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-3.jpeg and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-30.jpg b/docs/developer-guides/assets/beginners-guide-30.jpg
deleted file mode 100644
index d11cf8593b9..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-30.jpg and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-31.PNG b/docs/developer-guides/assets/beginners-guide-31.PNG
deleted file mode 100644
index d5e4354731d..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-31.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-32.PNG b/docs/developer-guides/assets/beginners-guide-32.PNG
deleted file mode 100644
index ca43bd7d5e2..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-32.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-33.PNG b/docs/developer-guides/assets/beginners-guide-33.PNG
deleted file mode 100644
index 8db0d560d60..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-33.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-34.PNG b/docs/developer-guides/assets/beginners-guide-34.PNG
deleted file mode 100644
index 44031182c00..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-34.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-35.PNG b/docs/developer-guides/assets/beginners-guide-35.PNG
deleted file mode 100644
index 0589e965645..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-35.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-36.PNG b/docs/developer-guides/assets/beginners-guide-36.PNG
deleted file mode 100644
index b7940894f7c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-36.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-37.PNG b/docs/developer-guides/assets/beginners-guide-37.PNG
deleted file mode 100644
index b87e49d5153..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-37.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-38.PNG b/docs/developer-guides/assets/beginners-guide-38.PNG
deleted file mode 100644
index 998ae11d201..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-38.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-39.PNG b/docs/developer-guides/assets/beginners-guide-39.PNG
deleted file mode 100644
index f1954f85f55..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-39.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-4.png b/docs/developer-guides/assets/beginners-guide-4.png
deleted file mode 100644
index edf94f94ca9..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-4.png and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-40.PNG b/docs/developer-guides/assets/beginners-guide-40.PNG
deleted file mode 100644
index 20bd51ca2dd..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-40.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-41.PNG b/docs/developer-guides/assets/beginners-guide-41.PNG
deleted file mode 100644
index 874d0650421..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-41.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-42.PNG b/docs/developer-guides/assets/beginners-guide-42.PNG
deleted file mode 100644
index 2cbac05b0ee..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-42.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-43.PNG b/docs/developer-guides/assets/beginners-guide-43.PNG
deleted file mode 100644
index 0ea5e6b35a2..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-43.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-44.PNG b/docs/developer-guides/assets/beginners-guide-44.PNG
deleted file mode 100644
index afff10b9eae..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-44.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-45.PNG b/docs/developer-guides/assets/beginners-guide-45.PNG
deleted file mode 100644
index 28267e716fc..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-45.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-46.PNG b/docs/developer-guides/assets/beginners-guide-46.PNG
deleted file mode 100644
index 640488b3a94..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-46.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-47.PNG b/docs/developer-guides/assets/beginners-guide-47.PNG
deleted file mode 100644
index f5da8338ddc..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-47.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-48.PNG b/docs/developer-guides/assets/beginners-guide-48.PNG
deleted file mode 100644
index 1f718dc7633..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-48.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-49.PNG b/docs/developer-guides/assets/beginners-guide-49.PNG
deleted file mode 100644
index d26718a6c54..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-49.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-5.PNG b/docs/developer-guides/assets/beginners-guide-5.PNG
deleted file mode 100644
index 3d9a043a2cb..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-5.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-50.PNG b/docs/developer-guides/assets/beginners-guide-50.PNG
deleted file mode 100644
index 3813ff820a4..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-50.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-51.PNG b/docs/developer-guides/assets/beginners-guide-51.PNG
deleted file mode 100644
index ec0d99bc37b..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-51.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-52.PNG b/docs/developer-guides/assets/beginners-guide-52.PNG
deleted file mode 100644
index 1d9d6afde40..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-52.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-53.PNG b/docs/developer-guides/assets/beginners-guide-53.PNG
deleted file mode 100644
index 4f4d4cccb4c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-53.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-54.PNG b/docs/developer-guides/assets/beginners-guide-54.PNG
deleted file mode 100644
index 7fb030ebc60..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-54.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-55.PNG b/docs/developer-guides/assets/beginners-guide-55.PNG
deleted file mode 100644
index de8c4060577..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-55.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-56.PNG b/docs/developer-guides/assets/beginners-guide-56.PNG
deleted file mode 100644
index ce2341805d0..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-56.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-57.PNG b/docs/developer-guides/assets/beginners-guide-57.PNG
deleted file mode 100644
index f5fdf7418eb..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-57.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-58.png b/docs/developer-guides/assets/beginners-guide-58.png
deleted file mode 100644
index 57b610611c4..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-58.png and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-59.PNG b/docs/developer-guides/assets/beginners-guide-59.PNG
deleted file mode 100644
index 7c7da57d4be..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-59.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-6.PNG b/docs/developer-guides/assets/beginners-guide-6.PNG
deleted file mode 100644
index fb4a2f8ef32..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-6.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-60.PNG b/docs/developer-guides/assets/beginners-guide-60.PNG
deleted file mode 100644
index 13fd6ee1c06..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-60.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-61.PNG b/docs/developer-guides/assets/beginners-guide-61.PNG
deleted file mode 100644
index 283cdf24557..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-61.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-62.PNG b/docs/developer-guides/assets/beginners-guide-62.PNG
deleted file mode 100644
index 887b4b7ae0d..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-62.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-63.PNG b/docs/developer-guides/assets/beginners-guide-63.PNG
deleted file mode 100644
index fc3ec17392e..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-63.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-64.PNG b/docs/developer-guides/assets/beginners-guide-64.PNG
deleted file mode 100644
index f11a090c8c0..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-64.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-65.PNG b/docs/developer-guides/assets/beginners-guide-65.PNG
deleted file mode 100644
index 48198c4725f..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-65.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-66.PNG b/docs/developer-guides/assets/beginners-guide-66.PNG
deleted file mode 100644
index 52bf65dfd64..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-66.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-67.PNG b/docs/developer-guides/assets/beginners-guide-67.PNG
deleted file mode 100644
index 7899e55aa44..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-67.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-68.PNG b/docs/developer-guides/assets/beginners-guide-68.PNG
deleted file mode 100644
index 5cd81e0294d..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-68.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-69.PNG b/docs/developer-guides/assets/beginners-guide-69.PNG
deleted file mode 100644
index b38a0e181da..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-69.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-7.PNG b/docs/developer-guides/assets/beginners-guide-7.PNG
deleted file mode 100644
index b7940894f7c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-7.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-70.PNG b/docs/developer-guides/assets/beginners-guide-70.PNG
deleted file mode 100644
index fad2fb14ee5..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-70.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-71.png b/docs/developer-guides/assets/beginners-guide-71.png
deleted file mode 100644
index c48aee6160c..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-71.png and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-8.PNG b/docs/developer-guides/assets/beginners-guide-8.PNG
deleted file mode 100644
index c8b08ac8150..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-8.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/beginners-guide-9.PNG b/docs/developer-guides/assets/beginners-guide-9.PNG
deleted file mode 100644
index b75654ed0e8..00000000000
Binary files a/docs/developer-guides/assets/beginners-guide-9.PNG and /dev/null differ
diff --git a/docs/developer-guides/assets/data-8204-explorer-queries-1.png b/docs/developer-guides/assets/data-8204-explorer-queries-1.png
deleted file mode 100644
index 0248e897511..00000000000
Binary files a/docs/developer-guides/assets/data-8204-explorer-queries-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/featured-topic-list-1.png b/docs/developer-guides/assets/featured-topic-list-1.png
deleted file mode 100644
index 9841351578b..00000000000
Binary files a/docs/developer-guides/assets/featured-topic-list-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/fetch-all-posts-1.png b/docs/developer-guides/assets/fetch-all-posts-1.png
deleted file mode 100644
index b0c92c91c49..00000000000
Binary files a/docs/developer-guides/assets/fetch-all-posts-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/grant-custom-badge-1.png b/docs/developer-guides/assets/grant-custom-badge-1.png
deleted file mode 100644
index 90ffda7bd9d..00000000000
Binary files a/docs/developer-guides/assets/grant-custom-badge-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/reverse-engineer-the-api-1.png b/docs/developer-guides/assets/reverse-engineer-the-api-1.png
deleted file mode 100644
index 7a5990ba6a1..00000000000
Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-1.png and /dev/null differ
diff --git a/docs/developer-guides/assets/reverse-engineer-the-api-2.png b/docs/developer-guides/assets/reverse-engineer-the-api-2.png
deleted file mode 100644
index 13e6dea703e..00000000000
Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-2.png and /dev/null differ
diff --git a/docs/developer-guides/assets/reverse-engineer-the-api-3.png b/docs/developer-guides/assets/reverse-engineer-the-api-3.png
deleted file mode 100644
index 992f152f01f..00000000000
Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-3.png and /dev/null differ
diff --git a/docs/developer-guides/assets/reverse-engineer-the-api-4.png b/docs/developer-guides/assets/reverse-engineer-the-api-4.png
deleted file mode 100644
index c4b855a8878..00000000000
Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-4.png and /dev/null differ
diff --git a/docs/developer-guides/assets/reverse-engineer-the-api-5.png b/docs/developer-guides/assets/reverse-engineer-the-api-5.png
deleted file mode 100644
index 74f01d3695a..00000000000
Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-5.png and /dev/null differ
diff --git a/docs/developer-guides/assets/theme-settings-3.png b/docs/developer-guides/assets/theme-settings-3.png
deleted file mode 100644
index 5ff00d642ff..00000000000
Binary files a/docs/developer-guides/assets/theme-settings-3.png and /dev/null differ
diff --git a/docs/developer-guides/check_unused_assets b/docs/developer-guides/check_unused_assets
new file mode 100755
index 00000000000..67b073733d1
--- /dev/null
+++ b/docs/developer-guides/check_unused_assets
@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# sync_docs only uploads assets that a doc links to, so anything else in
+# assets/ is never published and only adds weight to the repo.
+
+require_relative "lib/local_doc"
+
+referenced =
+ Dir
+ .glob("#{LocalDoc::DOCS_DIR}/**/*.md")
+ .flat_map { |path| File.read(path).scan(LocalDoc::IMAGE_REGEX).flatten }
+ .filter_map { |link| File.expand_path("#{__dir__}/#{link}") if link.start_with?("/assets/") }
+ .to_set
+
+unused =
+ Dir
+ .glob("#{__dir__}/assets/**/*")
+ .select { |path| File.file?(path) }
+ .reject { |path| referenced.include?(path) }
+ .sort
+
+if unused.empty?
+ puts "All assets are referenced by a doc."
+ exit 0
+end
+
+puts "These assets are not referenced by any doc. Remove them, or link to them from a doc:"
+unused.each { |path| puts " #{path.delete_prefix("#{__dir__}/")}" }
+exit 1
diff --git a/docs/developer-guides/lib/local_doc.rb b/docs/developer-guides/lib/local_doc.rb
index 5127dea7ae8..72c53542589 100644
--- a/docs/developer-guides/lib/local_doc.rb
+++ b/docs/developer-guides/lib/local_doc.rb
@@ -9,6 +9,9 @@ class LocalDoc
# fragments are dropped on sync because Discourse heading anchors include the post id.
DOC_LINK_REGEX = %r{\]\((?![a-z][a-z0-9+.-]*:|/)([^)\s#]+\.md)(?:#[^)\s]*)?\)}i
+ # Markdown images, e.g. `![alt](/assets/image.png)`. Captures the path.
+ IMAGE_REGEX = /![^\]]+\]\(([^)]+)\)/
+
attr_accessor :path,
:frontmatter,
:content,
@@ -38,7 +41,7 @@ class LocalDoc
unused_assets = assets.dup
result =
- content.gsub(/![^\]]+\]\(([^)]+)\)/) do |match|
+ content.gsub(IMAGE_REGEX) do |match|
path = $1
next match if !path.start_with?("/")