Deployed a870565 with MkDocs version: 1.4.2

changelog/index.html

@@ -1156,7 +1156,7 @@ <h3 id="main-branch-no-tagrelease">main branch (no tag/release)</h3>
 </ul>
 <h3 id="documentation">Documentation</h3>
 <ul>
-<li>November 1, 2024: Updated docs on "<a href="/islandora_workbench_docs/alt_text/">Adding alt text to images</a>".</li>
+<li>November 1, 2024: Updated docs on "<a href="/islandora_workbench_docs/alt_text/">Adding alt text to images</a>" and "<a href="/islandora_workbench_docs/limitations/">Known limitations</a>".</li>
 <li>October 20, 2024: Updated docs on "<a href="/islandora_workbench_docs/redirects/">Creating redirects</a>".</li>
 <li>October 14, 2024: Added docs on populating the "<a href="/islandora_workbench_docs/fields/#values-in-the-field_domain_access-column">field_domain_access</a>" CSV column. Thanks for the docs @dara2!</li>
 <li>September 23, 2024: Updated docs on "<a href="/islandora_workbench_docs/check/">Checking configuration and input data</a>" to include new config setting <code>check_lock_file_path</code>.</li>

limitations/index.html

@@ -908,6 +908,13 @@
     Setting destination filesystem for media is not possible
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#workbench-cannot-modify-media-automatically-generated-by-islandoras-microservices" class="md-nav__link">
+    Workbench cannot modify media automatically generated by Islandora's microservices
+  </a>
+
 </li>
 
     </ul>
@@ -1042,6 +1049,13 @@
     Setting destination filesystem for media is not possible
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#workbench-cannot-modify-media-automatically-generated-by-islandoras-microservices" class="md-nav__link">
+    Workbench cannot modify media automatically generated by Islandora's microservices
+  </a>
+
 </li>
 
     </ul>
@@ -1089,6 +1103,9 @@ <h2 id="workbench-doesnt-support-taxonomy-reference-fields-that-use-the-filter-b
 <h2 id="setting-destination-filesystem-for-media-is-not-possible">Setting destination filesystem for media is not possible</h2>
 <p>Drupal's REST interface for file fields does not allow overriding the "upload destination" (filesystem) that is defined in a media type's file field configuration. For example, if a file field is configured to use the "Flysystem: fedora" upload destination, you cannot tell Workbench to use the "Public Files" upload destination instead.</p>
 <p>Note that the <code>drupal_filesystem</code> configuration setting only applied to Drupal versions 8.x - 9.1. In Drupal 9.2 or later, this setting is ignored.</p>
+<h2 id="workbench-cannot-modify-media-automatically-generated-by-islandoras-microservices">Workbench cannot modify media automatically generated by Islandora's microservices</h2>
+<p>Islandora uses Contexts to initiate the generation of derivative media. Configuration for these Contexts is available in the "Derivatives" section of <code>admin/structure/context</code>. One example of a derivative media is a thumbnail generated on the ingestion of a JPEG original file.</p>
+<p>During <code>create</code> or <code>add_media</code> tasks, Workbench cannot modify or even be aware of derivative media automatically generated by Islandora. For example, Workbench can't add alt text to a thumbnail image automatically created by the "Image derivatives" Context. This is because the derivative media are generated asynchronously by Islandora's job processing queue. In other words, there is no predictable relationship between when an Original file is created by Workbench (or uploaded by a user in the Drupal content management forms) and when the thumbnail file is generated by Islandora's microservices. This unpredictability prevents Workbench from knowing when the derivative will be or has been created, making it impossible to have Workbench automatically add alt text to that thumbnail.</p>