[release-1.7] RHIDP-7802: Adding short description to Home cards (#1404)

* Added required text

* Incorporated Fabrice's comments

* Fixing indentation error

* Indentation issues

* Incorporated Eswar's comment

---------

Co-authored-by: Priyanka Abel <[email protected]>

Author: openshift-cherrypick-robot

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

@@ -5,7 +5,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:
 
@@ -58,6 +67,8 @@ dynamicPlugins:
 
 Search::
 +
+You can use the *SearchBar* card to provide essential search functionality directly on the Home page. 
++
 --
 [source,yaml]
 ----
@@ -93,6 +104,8 @@ dynamicPlugins:
 
 Quick access::
 +
+You can use the *QuickAccessCard* card to function as a customizable shortcut panel.
++
 --
 [source,yaml]
 ----
@@ -128,6 +141,8 @@ dynamicPlugins:
 
 Headline::
 +
+You can use the *Headline* card to display important information.
++
 --
 [source,yaml]
 ----
@@ -161,6 +176,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 +231,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 +258,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 +274,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]
 ----
@@ -267,7 +290,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]
 ----
@@ -292,6 +316,7 @@ dynamicPlugins:
 OnboardingSection::
 +
 You can use the *OnboardingSection* card to quickly discover learning resources within {product-very-short}.
++
 --
 [source,yaml]
 ----
@@ -315,6 +340,7 @@ dynamicPlugins:
 TemplateSection::
 +
 You can use the *TemplateSection* card to quickly explore and initiate software templates in {product-very-short}.
++
 --
 [source,yaml]
 ----