Merge branch 'develop' of https://github.com/magento/devdocs_internal into am_symlinks

merged with develop

Author: marchenk-adobe

guides/v2.0/frontend-dev-guide/themes/admin_theme_create.md

@@ -20,7 +20,7 @@ This topic describes how to create your custom theme for Magento Admin, referenc
 
 [Set]({{page.baseurl}}config-guide/cli/config-cli-subcommands-mode.html) your Magento application to the developer [mode]({{page.baseurl}}config-guide/bootstrap/magento-modes.html). The application mode influences the way static files are cached by Magento. 
 
-## Create an Admin theme
+## Overview
 
 To create a custom Admin theme, take the following steps:
 
@@ -32,10 +32,10 @@ To create a custom Admin theme, take the following steps:
 
 Each step is described further.
 
-### Create a theme directory {#create_dir}
+## Create a theme directory {#create_dir}
 In the `app/design/adminhtml` directory create a new `<Vendor>/<admin_theme>` directory.
 
-### Add a declaration `theme.xml` {#declare_theme}
+## Add a declaration `theme.xml` {#declare_theme}
 
 In the theme directory, add `theme.xml` containing at least the theme name and the parent theme name (if the theme [inherits]({{page.baseurl}}frontend-dev-guide/themes/theme-inherit.html) from one). We recommend you to inherit from the default Magento Admin theme: `Magento/backend`.
 
@@ -49,9 +49,11 @@ Configure it using the following example (replace placeholders with your theme i
      <parent>%vendor_dir%/%parent_theme_dir%</parent> <!-- the parent theme. Example: Magento/backend -->
  </theme>
 
+If you change the theme title or parent theme information in `theme.xml` after a theme was already [registered](#register_theme), you need to open or reload any Magento Admin page for your changes to be saved in the database.
+
 {%endhighlight%}
 
-### Add `registration.php` {#add_registry}
+## Add `registration.php` {#add_registry}
 In your theme directory, create a `registration.php` file.
 In this file, add the following code, having replaced placeholders with your theme information:
 
@@ -68,16 +70,21 @@ In this file, add the following code, having replaced placeholders with your the
 );  
 {%endhighlight%}
 
-### Optionally add `composer.json` {#make_composer}
+## Optionally add `composer.json` {#make_composer}
 See the [Make your theme a Composer package (optional)]({{page.baseurl}}frontend-dev-guide/themes/theme-create.html#fedg_create_theme_composer)
 
 
-### Admin theme logo (optional) {#logo}
+## Admin theme logo (optional) {#logo}
 
 In the default `Magento/backend` theme `lib/web/images/magento-logo.svg` is used as theme logo. 
 To override it, in your theme directory, create a `web/images` sub-directory, and add your custom file named `magento-logo.svg`. 
 If you want to use the file with other name and/or format, you need to additionally declare it as described in [Declaring theme logo]({{page.baseurl}}frontend-dev-guide/themes/theme-create.html#logo_declare).
 
+
+## Theme registration {#register_theme}
+
+Once you open the Magento Admin (or reload any  Magento Admin page) having added the theme files to the files system, your theme gets registered and added to the database.
+
 ## Apply the Admin theme
 
 See the [Apply a custom Admin theme topic]({{page.baseurl}}frontend-dev-guide/themes/admin_theme.html).

guides/v2.0/frontend-dev-guide/themes/theme-create.md

@@ -65,6 +65,11 @@ After you create a directory for your theme, you must create `theme.xml` contain
  </theme>
 {% endhighlight %}
 
+<div class="bs-callout bs-callout-info" id="info">
+<p>If you update theme.xml later</p>
+</div>
+
+If you change the theme title or parent theme information in `theme.xml` after a theme was already [registered](#register_theme), you need to open or reload any Magento Admin page for your changes to be saved in the database.
 
 ## Make your theme a Composer package (optional) {#fedg_create_theme_composer}
 
@@ -247,7 +252,12 @@ To learn more about theme layouts, refer to the <a href="{{page.baseurl}}fronten
 
 
 ## What's next {#next}
-See the [Apply and configure a theme in Admin]({{page.baseurl}}frontend-dev-guide/themes/theme-apply.html) topic.
+
+### Theme registration {#register_theme}
+Once you open the Magento Admin (or reload any  Magento Admin page) having added the theme files to the files system, your theme gets registered and added to the database.
+
+### Applying a theme
+For information on how to apply the theme for the storefront, see the [Apply and configure a theme in Admin]({{page.baseurl}}frontend-dev-guide/themes/theme-apply.html) topic.
 
 ## See also