Allow README.md to optionally render as the project page
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #1674976. -->
Reported by: [cashwilliams](https://www.drupal.org/user/421070)
Related to !157
>>>
<p>Currently blocked on:<br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-5"><a href="https://www.drupal.org/project/coding_standards/issues/2952616" title="Status: Closed (won't fix)">#2952616: Adopt CommonMark spec for Markdown files</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2949200" title="Status: Closed (fixed)">#2949200: Add drupalorg_versioncontrol_repo_changes hook</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/markdown/issues/2952435" title="Status: Closed (fixed)">#2952435: Merge in the CommonMark project</a></span></p>
<p>Allow module/theme maintainers to use a <code>README.md</code> instead of the project page.</p>
<p>In the latest patch implemented:</p>
<ol>
<li>An option to use content from <code>README.md</code> (only when the file is available) instead of "Description" field.</li>
<li>Availability to choose <code>README.md</code> from branches and tags.</li>
</ol>
<p>Need to test:</p>
<ol>
<li>Handle relative links to image/files, a README.md can include a link to a file in the project,so the parser has to rewrite the URL so it resolves to the git repository.</li>
</ol>
> Related issue: [Issue #2191525](https://www.drupal.org/node/2191525)
> Related issue: [Issue #2952435](https://www.drupal.org/node/2952435)
> Related issue: [Issue #3341892](https://www.drupal.org/node/3341892)
> Related issue: [Issue #2952616](https://www.drupal.org/node/2952616)
issue