>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3568219. --> Reported by: [marcus_johansson](https://www.drupal.org/user/385947) Related to !1109 >>> <p>[Tracker]<br> <strong>Update Summary: </strong>[One-line status update for stakeholders]<br> <strong>Short Description: </strong>[One-line issue summary for stakeholders]<br> <strong>Check-in Date: </strong>MM/DD/YYYY<br> <em>Metadata is used by the <a href="https://www.drupalstarforge.ai/" title="AI Tracker">AI Tracker.</a> Docs and additional fields <a href="https://www.drupalstarforge.ai/ai-dashboard/docs" title="AI Issue Tracker Documentation">here</a>.</em><br> [/Tracker]</p> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Since we use our repo as documentation, we do not really want to add images into the repo unless specifically needed to do so. We don't want to come to a point where you have to use <code>--depth 1</code> when you clone the repo. If we are serious about having people contributing is countries that might not have so stable Internet we need to keep the repo as lean as possible.</p> <p>This means that any images available should be first and foremost stored on the Gitlab wiki, since that is on the same parent domain, so hotlinking will be possible.</p> <p>We might also have support soon for Mermaid soon, that makes diagrams or chart possible to add without heavy overhead and with the advantage of them being versionable: <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/ai/issues/3534115" title="Status: Closed (fixed)">#3534115: Add Mermaid Diagrams possibility to documentation</a></span></p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Write best practices on how to work with images in the documentation section.</p>