>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3530672. --> Reported by: [quietone](https://www.drupal.org/user/2572884) Related to !65 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Long format API documents are difficult to write and maintain. One needs to understand the various tags and how the API site works. This is typically, *.api.php files.</p> <p>There is more history in the core issue to use Markdown for this, <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-13"><a href="https://www.drupal.org/project/drupal/issues/3463660" title="Status: Needs work">#3463660: Document high-level API concepts in an easier format</a></span>.</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Document high-level API concepts in an easier format.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <h3 id="summary-ui-changes">User interface changes</h3> <h3 id="summary-api-changes">API changes</h3> <h3 id="summary-data-model-changes">Data model changes</h3> > Related issue: [Issue #3463660](https://www.drupal.org/node/3463660)