From bf8aac36796165ad6688364089572e642f3a1bd4 Mon Sep 17 00:00:00 2001
From: Patrick Rauscher <prauscher@prauscher.de>
Date: Mon, 4 Sep 2023 20:32:21 +0200
Subject: [PATCH] [5.0.x] Fixed #34813 -- Doc'd usage of integrity HTML
 attribute with ManifestStaticFilesStorage.

Backport of 116e225266c511dfc0bfc96c8497e9c8aaa4d004 from main
---
 docs/ref/contrib/staticfiles.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/ref/contrib/staticfiles.txt b/docs/ref/contrib/staticfiles.txt
index d446f833ea..b7f7239223 100644
--- a/docs/ref/contrib/staticfiles.txt
+++ b/docs/ref/contrib/staticfiles.txt
@@ -323,6 +323,16 @@ For example, the ``'css/styles.css'`` file with this content:
 
     @import url("../admin/css/base.27e20196a850.css");
 
+.. admonition:: Usage of the ``integrity`` HTML attribute with local files
+
+    When using the optional ``integrity`` attribute within tags like
+    ``<script>`` or ``<link>``, its value should be calculated based on the
+    files as they are served, not as stored in the filesystem. This is
+    particularly important because depending on how static files are collected,
+    their checksum may have changed (for example when using
+    :djadmin:`collectstatic`). At the moment, there is no out-of-the-box
+    tooling available for this.
+
 You can change the location of the manifest file by using a custom
 ``ManifestStaticFilesStorage`` subclass that sets the ``manifest_storage``
 argument. For example::