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.ymlindex f7f69ab82c0..8889f2d30ee 100644--- a/.github/workflows/developer-docs-lint.yml+++ b/.github/workflows/developer-docs-lint.yml@@ -45,3 +45,24 @@ jobs:- name: Lintrun: 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_assetsdiff --git a/docs/developer-guides/README.md b/docs/developer-guides/README.mdindex 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. ToThe 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 docsdiff --git a/docs/developer-guides/assets/api-documentation-1.gif b/docs/developer-guides/assets/api-documentation-1.gifdeleted file mode 100644index fb983a08232..00000000000Binary files a/docs/developer-guides/assets/api-documentation-1.gif and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-1.png b/docs/developer-guides/assets/api-examples-1.pngdeleted file mode 100644index 709cd336255..00000000000Binary files a/docs/developer-guides/assets/api-examples-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-2.png b/docs/developer-guides/assets/api-examples-2.pngdeleted file mode 100644index 68087d105f1..00000000000Binary files a/docs/developer-guides/assets/api-examples-2.png and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-3.png b/docs/developer-guides/assets/api-examples-3.pngdeleted file mode 100644index 88926a268d3..00000000000Binary files a/docs/developer-guides/assets/api-examples-3.png and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-4.png b/docs/developer-guides/assets/api-examples-4.pngdeleted file mode 100644index bf8dd02722a..00000000000Binary files a/docs/developer-guides/assets/api-examples-4.png and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-5.png b/docs/developer-guides/assets/api-examples-5.pngdeleted file mode 100644index 3265d9553be..00000000000Binary files a/docs/developer-guides/assets/api-examples-5.png and /dev/null differdiff --git a/docs/developer-guides/assets/api-examples-6.png b/docs/developer-guides/assets/api-examples-6.pngdeleted file mode 100644index ccb233a90a7..00000000000Binary files a/docs/developer-guides/assets/api-examples-6.png and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-1.jpeg b/docs/developer-guides/assets/beginners-guide-1.jpegdeleted file mode 100644index 64e20db9090..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-1.jpeg and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-10.PNG b/docs/developer-guides/assets/beginners-guide-10.PNGdeleted file mode 100644index 97362134368..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-10.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-11.PNG b/docs/developer-guides/assets/beginners-guide-11.PNGdeleted file mode 100644index 952e7dd093e..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-11.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-13.PNG b/docs/developer-guides/assets/beginners-guide-13.PNGdeleted file mode 100644index b8f7d04b0a8..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-13.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-14.PNG b/docs/developer-guides/assets/beginners-guide-14.PNGdeleted file mode 100644index 805d0729f7e..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-14.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-15.jpg b/docs/developer-guides/assets/beginners-guide-15.jpgdeleted file mode 100644index 3682b4540c8..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-15.jpg and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-16.PNG b/docs/developer-guides/assets/beginners-guide-16.PNGdeleted file mode 100644index a64810930f9..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-16.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-17.PNG b/docs/developer-guides/assets/beginners-guide-17.PNGdeleted file mode 100644index 97362134368..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-17.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-18.PNG b/docs/developer-guides/assets/beginners-guide-18.PNGdeleted file mode 100644index 4b7c7291280..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-18.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-19.PNG b/docs/developer-guides/assets/beginners-guide-19.PNGdeleted file mode 100644index 934feddd3f6..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-19.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-2.jpeg b/docs/developer-guides/assets/beginners-guide-2.jpegdeleted file mode 100644index 21b55ee05f8..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-2.jpeg and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-20.PNG b/docs/developer-guides/assets/beginners-guide-20.PNGdeleted file mode 100644index 42b737d5650..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-20.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-21.PNG b/docs/developer-guides/assets/beginners-guide-21.PNGdeleted file mode 100644index 0260e9cf070..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-21.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-22.PNG b/docs/developer-guides/assets/beginners-guide-22.PNGdeleted file mode 100644index 805a27e0244..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-22.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-23.PNG b/docs/developer-guides/assets/beginners-guide-23.PNGdeleted file mode 100644index 1a41cd9ab9c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-23.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-24.PNG b/docs/developer-guides/assets/beginners-guide-24.PNGdeleted file mode 100644index 7753853308e..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-24.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-25.PNG b/docs/developer-guides/assets/beginners-guide-25.PNGdeleted file mode 100644index 827eab1f20c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-25.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-26.PNG b/docs/developer-guides/assets/beginners-guide-26.PNGdeleted file mode 100644index ca43bd7d5e2..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-26.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-27.PNG b/docs/developer-guides/assets/beginners-guide-27.PNGdeleted file mode 100644index 478508a7031..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-27.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-28.PNG b/docs/developer-guides/assets/beginners-guide-28.PNGdeleted file mode 100644index 9e8a50936b7..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-28.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-29.PNG b/docs/developer-guides/assets/beginners-guide-29.PNGdeleted file mode 100644index 5a13de291ee..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-29.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-3.jpeg b/docs/developer-guides/assets/beginners-guide-3.jpegdeleted file mode 100644index 514ce1e4544..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-3.jpeg and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-30.jpg b/docs/developer-guides/assets/beginners-guide-30.jpgdeleted file mode 100644index d11cf8593b9..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-30.jpg and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-31.PNG b/docs/developer-guides/assets/beginners-guide-31.PNGdeleted file mode 100644index d5e4354731d..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-31.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-32.PNG b/docs/developer-guides/assets/beginners-guide-32.PNGdeleted file mode 100644index ca43bd7d5e2..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-32.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-33.PNG b/docs/developer-guides/assets/beginners-guide-33.PNGdeleted file mode 100644index 8db0d560d60..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-33.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-34.PNG b/docs/developer-guides/assets/beginners-guide-34.PNGdeleted file mode 100644index 44031182c00..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-34.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-35.PNG b/docs/developer-guides/assets/beginners-guide-35.PNGdeleted file mode 100644index 0589e965645..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-35.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-36.PNG b/docs/developer-guides/assets/beginners-guide-36.PNGdeleted file mode 100644index b7940894f7c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-36.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-37.PNG b/docs/developer-guides/assets/beginners-guide-37.PNGdeleted file mode 100644index b87e49d5153..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-37.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-38.PNG b/docs/developer-guides/assets/beginners-guide-38.PNGdeleted file mode 100644index 998ae11d201..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-38.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-39.PNG b/docs/developer-guides/assets/beginners-guide-39.PNGdeleted file mode 100644index f1954f85f55..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-39.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-4.png b/docs/developer-guides/assets/beginners-guide-4.pngdeleted file mode 100644index edf94f94ca9..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-4.png and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-40.PNG b/docs/developer-guides/assets/beginners-guide-40.PNGdeleted file mode 100644index 20bd51ca2dd..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-40.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-41.PNG b/docs/developer-guides/assets/beginners-guide-41.PNGdeleted file mode 100644index 874d0650421..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-41.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-42.PNG b/docs/developer-guides/assets/beginners-guide-42.PNGdeleted file mode 100644index 2cbac05b0ee..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-42.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-43.PNG b/docs/developer-guides/assets/beginners-guide-43.PNGdeleted file mode 100644index 0ea5e6b35a2..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-43.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-44.PNG b/docs/developer-guides/assets/beginners-guide-44.PNGdeleted file mode 100644index afff10b9eae..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-44.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-45.PNG b/docs/developer-guides/assets/beginners-guide-45.PNGdeleted file mode 100644index 28267e716fc..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-45.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-46.PNG b/docs/developer-guides/assets/beginners-guide-46.PNGdeleted file mode 100644index 640488b3a94..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-46.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-47.PNG b/docs/developer-guides/assets/beginners-guide-47.PNGdeleted file mode 100644index f5da8338ddc..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-47.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-48.PNG b/docs/developer-guides/assets/beginners-guide-48.PNGdeleted file mode 100644index 1f718dc7633..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-48.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-49.PNG b/docs/developer-guides/assets/beginners-guide-49.PNGdeleted file mode 100644index d26718a6c54..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-49.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-5.PNG b/docs/developer-guides/assets/beginners-guide-5.PNGdeleted file mode 100644index 3d9a043a2cb..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-5.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-50.PNG b/docs/developer-guides/assets/beginners-guide-50.PNGdeleted file mode 100644index 3813ff820a4..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-50.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-51.PNG b/docs/developer-guides/assets/beginners-guide-51.PNGdeleted file mode 100644index ec0d99bc37b..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-51.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-52.PNG b/docs/developer-guides/assets/beginners-guide-52.PNGdeleted file mode 100644index 1d9d6afde40..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-52.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-53.PNG b/docs/developer-guides/assets/beginners-guide-53.PNGdeleted file mode 100644index 4f4d4cccb4c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-53.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-54.PNG b/docs/developer-guides/assets/beginners-guide-54.PNGdeleted file mode 100644index 7fb030ebc60..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-54.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-55.PNG b/docs/developer-guides/assets/beginners-guide-55.PNGdeleted file mode 100644index de8c4060577..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-55.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-56.PNG b/docs/developer-guides/assets/beginners-guide-56.PNGdeleted file mode 100644index ce2341805d0..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-56.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-57.PNG b/docs/developer-guides/assets/beginners-guide-57.PNGdeleted file mode 100644index f5fdf7418eb..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-57.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-58.png b/docs/developer-guides/assets/beginners-guide-58.pngdeleted file mode 100644index 57b610611c4..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-58.png and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-59.PNG b/docs/developer-guides/assets/beginners-guide-59.PNGdeleted file mode 100644index 7c7da57d4be..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-59.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-6.PNG b/docs/developer-guides/assets/beginners-guide-6.PNGdeleted file mode 100644index fb4a2f8ef32..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-6.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-60.PNG b/docs/developer-guides/assets/beginners-guide-60.PNGdeleted file mode 100644index 13fd6ee1c06..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-60.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-61.PNG b/docs/developer-guides/assets/beginners-guide-61.PNGdeleted file mode 100644index 283cdf24557..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-61.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-62.PNG b/docs/developer-guides/assets/beginners-guide-62.PNGdeleted file mode 100644index 887b4b7ae0d..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-62.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-63.PNG b/docs/developer-guides/assets/beginners-guide-63.PNGdeleted file mode 100644index fc3ec17392e..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-63.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-64.PNG b/docs/developer-guides/assets/beginners-guide-64.PNGdeleted file mode 100644index f11a090c8c0..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-64.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-65.PNG b/docs/developer-guides/assets/beginners-guide-65.PNGdeleted file mode 100644index 48198c4725f..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-65.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-66.PNG b/docs/developer-guides/assets/beginners-guide-66.PNGdeleted file mode 100644index 52bf65dfd64..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-66.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-67.PNG b/docs/developer-guides/assets/beginners-guide-67.PNGdeleted file mode 100644index 7899e55aa44..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-67.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-68.PNG b/docs/developer-guides/assets/beginners-guide-68.PNGdeleted file mode 100644index 5cd81e0294d..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-68.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-69.PNG b/docs/developer-guides/assets/beginners-guide-69.PNGdeleted file mode 100644index b38a0e181da..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-69.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-7.PNG b/docs/developer-guides/assets/beginners-guide-7.PNGdeleted file mode 100644index b7940894f7c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-7.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-70.PNG b/docs/developer-guides/assets/beginners-guide-70.PNGdeleted file mode 100644index fad2fb14ee5..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-70.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-71.png b/docs/developer-guides/assets/beginners-guide-71.pngdeleted file mode 100644index c48aee6160c..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-71.png and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-8.PNG b/docs/developer-guides/assets/beginners-guide-8.PNGdeleted file mode 100644index c8b08ac8150..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-8.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/beginners-guide-9.PNG b/docs/developer-guides/assets/beginners-guide-9.PNGdeleted file mode 100644index b75654ed0e8..00000000000Binary files a/docs/developer-guides/assets/beginners-guide-9.PNG and /dev/null differdiff --git a/docs/developer-guides/assets/data-8204-explorer-queries-1.png b/docs/developer-guides/assets/data-8204-explorer-queries-1.pngdeleted file mode 100644index 0248e897511..00000000000Binary files a/docs/developer-guides/assets/data-8204-explorer-queries-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/featured-topic-list-1.png b/docs/developer-guides/assets/featured-topic-list-1.pngdeleted file mode 100644index 9841351578b..00000000000Binary files a/docs/developer-guides/assets/featured-topic-list-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/fetch-all-posts-1.png b/docs/developer-guides/assets/fetch-all-posts-1.pngdeleted file mode 100644index b0c92c91c49..00000000000Binary files a/docs/developer-guides/assets/fetch-all-posts-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/grant-custom-badge-1.png b/docs/developer-guides/assets/grant-custom-badge-1.pngdeleted file mode 100644index 90ffda7bd9d..00000000000Binary files a/docs/developer-guides/assets/grant-custom-badge-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/reverse-engineer-the-api-1.png b/docs/developer-guides/assets/reverse-engineer-the-api-1.pngdeleted file mode 100644index 7a5990ba6a1..00000000000Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-1.png and /dev/null differdiff --git a/docs/developer-guides/assets/reverse-engineer-the-api-2.png b/docs/developer-guides/assets/reverse-engineer-the-api-2.pngdeleted file mode 100644index 13e6dea703e..00000000000Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-2.png and /dev/null differdiff --git a/docs/developer-guides/assets/reverse-engineer-the-api-3.png b/docs/developer-guides/assets/reverse-engineer-the-api-3.pngdeleted file mode 100644index 992f152f01f..00000000000Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-3.png and /dev/null differdiff --git a/docs/developer-guides/assets/reverse-engineer-the-api-4.png b/docs/developer-guides/assets/reverse-engineer-the-api-4.pngdeleted file mode 100644index c4b855a8878..00000000000Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-4.png and /dev/null differdiff --git a/docs/developer-guides/assets/reverse-engineer-the-api-5.png b/docs/developer-guides/assets/reverse-engineer-the-api-5.pngdeleted file mode 100644index 74f01d3695a..00000000000Binary files a/docs/developer-guides/assets/reverse-engineer-the-api-5.png and /dev/null differdiff --git a/docs/developer-guides/assets/theme-settings-3.png b/docs/developer-guides/assets/theme-settings-3.pngdeleted file mode 100644index 5ff00d642ff..00000000000Binary files a/docs/developer-guides/assets/theme-settings-3.png and /dev/null differdiff --git a/docs/developer-guides/check_unused_assets b/docs/developer-guides/check_unused_assetsnew file mode 100755index 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 1diff --git a/docs/developer-guides/lib/local_doc.rb b/docs/developer-guides/lib/local_doc.rbindex 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. ``. Captures the path.+ IMAGE_REGEX = /![^\]]+\]\(([^)]+)\)/+attr_accessor :path,:frontmatter,:content,@@ -38,7 +41,7 @@ class LocalDocunused_assets = assets.dupresult =- content.gsub(/![^\]]+\]\(([^)]+)\)/) do |match|+ content.gsub(IMAGE_REGEX) do |match|path = $1next match if !path.start_with?("/")