RHIDP-7802: Adding short description to Home cards (#1396)

* Added required text

* Incorporated Fabrice's comments

* Fixing indentation error

* Indentation issues

* Incorporated Eswar's comment

Author: pabel-rh

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

@@ -3,7 +3,16 @@
 [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:
 
@@ -56,6 +65,8 @@ dynamicPlugins:
 
 Search::
 +
+You can use the *SearchBar* card to provide essential search functionality directly on the Home page. 
++
 --
 [source,yaml]
 ----
@@ -91,6 +102,8 @@ dynamicPlugins:
 
 Quick access::
 +
+You can use the *QuickAccessCard* card to function as a customizable shortcut panel.
++
 --
 [source,yaml]
 ----
@@ -126,6 +139,8 @@ dynamicPlugins:
 
 Headline::
 +
+You can use the *Headline* card to display important information.
++
 --
 [source,yaml]
 ----
@@ -159,6 +174,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]
 ----
@@ -212,6 +229,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]
 ----
@@ -237,6 +256,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]
 ----
@@ -251,6 +272,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]
 ----
@@ -265,7 +288,8 @@ dynamicPlugins:
 
 EntitySection::
 +
-You can use the *EntitySection* card to create a visually engaging section that highlights catalog entities of various kinds, such as components, APIs, resources, and so on.
+You can use the *EntitySection* card to create a visually engaging section that highlights catalog entities of various kinds, such as `Component`, `API`, `Resource`, and `System`.
++
 --
 [source,yaml]
 ----
@@ -290,6 +314,7 @@ dynamicPlugins:
 OnboardingSection::
 +
 You can use the *OnboardingSection* card to quickly discover learning resources within {product-very-short}.
++
 --
 [source,yaml]
 ----
@@ -313,6 +338,7 @@ dynamicPlugins:
 TemplateSection::
 +
 You can use the *TemplateSection* card to quickly explore and initiate software templates in {product-very-short}.
++
 --
 [source,yaml]
 ----