Manual cherrpick for PR-1396

modules/customizing-the-home-page/proc-customizing-the-home-page-cards.adoc

@@ -5,7 +5,15 @@
 [id="customizing-the-home-page-cards_{context}"]
 = Customizing the Home page cards
 
-Administrators can change the fixed height of cards that are in a 12-column grid.
+As an administrator, you can customize the layout and content of the Home page to create a tailored user experience. This includes integrating various specialized cards into the primary view.
+
+The Home page layout uses a 12-column grid system. You can precisely define the position (x), width (w), and height (h) for each card across multiple screen breakpoints:
+* Extra-large (xl)
+* Large (lg)
+* Medium (md)
+* Small (sm)
+* Extra-small (xs)
+* Extra-extra-small (xxs)
 
 The default Home page is as shown in the following `{my-app-config-file}` file configuration:
 
@@ -58,6 +66,8 @@ dynamicPlugins:
 
 Search::
 +
+You can use the *SearchBar* card to provide essential search functionality directly on the Home page. 
++
 --
 [source,yaml]
 ----
@@ -93,6 +103,8 @@ dynamicPlugins:
 
 Quick access::
 +
+You can use the *QuickAccessCard* card to function as a customizable shortcut panel.
++
 --
 [source,yaml]
 ----
@@ -128,6 +140,8 @@ dynamicPlugins:
 
 Headline::
 +
+You can use the *Headline* card to display important information.
++
 --
 [source,yaml]
 ----
@@ -161,6 +175,8 @@ dynamicPlugins:
 
 Markdown::
 +
+You can use the *Markdown* card to display richly formatted content directly within the Home page layout. This card uses Markdown syntax to present structured information, such as lists and links (documentation and plugin repositories).
++
 --
 [source,yaml]
 ----
@@ -214,6 +230,8 @@ dynamicPlugins:
 
 Placeholder::
 +
+You can use the *Placeholder* card as a utility element for reserving space or for layout testing on the Home page.
++
 --
 [source,yaml]
 ----
@@ -239,6 +257,8 @@ dynamicPlugins:
 
 Catalog starred entities::
 +
+You can use the *CatalogStarredEntitiesCard* card to provide a dedicated space on the Home page for users to view catalog entities that they have marked as starred.
++
 --
 [source,yaml]
 ----
@@ -253,6 +273,8 @@ dynamicPlugins:
 
 Featured docs::
 +
+You can use the *FeaturedDocsCard* card as a way to highlight specific documentation within {product}, as it is available for deployment on the Home page.
++
 --
 [source,yaml]
 ----
@@ -263,4 +285,4 @@ dynamicPlugins:
         - mountPoint: home.page/cards
           importName: FeaturedDocsCard
 ----
---
+--