Document how to customize Mercury when used with Drupal CMS Starter
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #3570020. -->
Reported by: [pameeela](https://www.drupal.org/user/1431110)
Related to !185
>>>
<h3 id="summary-problem-motivation">Problem/Motivation</h3>
<p>The steps for customizing Mercury provided in this project only work when it is used outside of Drupal CMS, because Starter ships with a demo homepage and content template for the utility page that are tied to the Mercury namespace. So if you use Mercury as a starterkit for a pre-installed site based on Starter, your home page and utility page will be broken.</p>
<p>This is kind of a wider issue about the recommended steps for changing your theme if you have Canvas content or config that relies on the existing theme, but we should figure out the advice we want to give.</p>
<p>For Byte, because it includes way more and would be way more broken if you change the theme name, we recommend just copying it into a custom theme and removing it via Composer:</p>
<pre>mkdir -p web/themes/custom<br>cp -R web/themes/contrib/byte_theme web/themes/custom/byte_theme<br>git add web/themes/custom/byte_theme<br>composer remove drupal/byte_theme</pre>
issue