Improve Luigi readme files

README.md

@@ -2,36 +2,21 @@
 
 ## Overview
 
-Luigi is a micro front-end JavaScript framework that enables the creation of an administrative user interface which is driven by local and distributed views. Luigi enables the communication between a web application and content-views which the application contains such as routing, navigation, authorization, and user experience elements.
+Luigi is a micro front-end JavaScript framework that enables the creation of an administrative user interface driven by local and distributed views. Luigi enables the communication between a web application and content-views which the application contains such as routing, navigation, authorization, and user experience elements.
 
-Luigi consists of two components: **Luigi core** and **Luigi client**.
-
- **Luigi core** is installed in the web application while **Luigi client** is installed in the application(s) running in the content-view. Both of these components interact with one another to leverage communication between both the web application and the content-view, without compromising the security principles behind the iframe pattern.
+Luigi consists of Luigi Core and Luigi Client applications. Luigi Core works in the web application, while Luigi Client is used by the application running in the content-view to communicate with the main application. Both of these components interact with each another to leverage communication between both the web application and the content-view, without compromising the security principles behind the iframe pattern.
 
 ## Installation
 
-### Luigi core
-
-Luigi core is the part of Luigi that enables navigation, security and routing. To get started with Luigi, read [this](docs/application-setup.md) document.
-
-- [Application setup](docs/application-setup.md) shows you the first steps to prepare your application for development.
-- [Navigation configuration](docs/navigation-configuration.md) shows you how to configure navigation.
-- [Authorization configuration](docs/authorization-configuration.md) shows you how to secure Luigi.
-- [General settings](docs/general-settings.md) provides you with configuration parameters.
-
-### Luigi client
-
-Luigi client enables integration of Luigi in views. You can easily configure the lifecycle and links of the client, as well as customize the appearance of your navigation.
+Follow the instructions in [this](docs/application-setup.md) document to get started with Luigi. Read [this](client/README.md) document to install the Luigi Client.
 
-- [Lifecycle](docs/luigi-client-api.md#lifecycle) gives you details on the life cycle of listeners, navigation nodes and event data.
-- [Link Manager](docs/luigi-client-api.md#linkmanager) allows you to navigate to a specific route.
-- [UX Manager](docs/luigi-client-api.md#uxmanager) helps you to manage the appearance in Luigi.
+View the [application examples](core/examples) to explore Luigi's features.
 
-See [this](https://github.com/kyma-project/luigi/blob/master/client/README.md) document to learn more about the Luigi client. 
+## Documentation
 
-View [example applications](/core/examples).
+For Luigi documentation, see [Luigi documentation](docs/README.md).
 
-### Code formatting for contributors
+## Code formatting for contributors
 
 All projects in the repository use [Prettier](https://prettier.io) to format source code. Run the `npm install` command in the root folder to install it along with [husky](https://github.com/typicode/husky), the Git hooks manager. Both tools ensure proper codebase formatting before committing it.
 

client/README.md

@@ -27,7 +27,7 @@ You can see the Luigi Client in action by running the [Angular example applicati
 
 ## Usage
 
-Use additional instructions to work with Luigi Client.
+Additional instructions and guidelines you can use to work with Luigi Client.
 
 
 ### Generate documentation

docs/README.md

@@ -1,18 +1,21 @@
-# Documentation
+# Luigi Documentation
 
-## Getting started
+Read the documentation to explore the features of Luigi Core and Luigi Client.
 
-This directory contains the following documents that relate to the project:
+## Luigi Core
 
-**Luigi Core**
+Set up and configure the main application.
 
 * [Application setup](application-setup.md) shows you the first steps to prepare your application for development.
 * [Navigation configuration](navigation-configuration.md) shows you how to configure navigation in Luigi.
 * [Authorization configuration](authorization-configuration.md) guides you through the configuration to secure Luigi.
 * [General settings](general-settings.md) provides you with additional configuration parameters for Luigi.
 
-**Luigi Client**
+## Luigi Client
 
-* [Lifecycle](luigi-client-api.md#lifecycle) gives you details on the life cycle of listeners, navigation nodes and event data.
+
+Use the Luigi Client API documentation to learn more about the functions and parameters you can use to communicate with the core application to define lifecycle, links, and the appearance of the application.
+
+* [Lifecycle](luigi-client-api.md#lifecycle) gives you details on the life cycle of listeners, navigation nodes, and Event data.
 * [Link Manager](luigi-client-api.md#linkmanager) allows you to navigate to a specific route. 
-* [UX Manager](luigi-client-api.md#uxmanager) helps you to manage the appearance in Luigi.
+* [UX Manager](luigi-client-api.md#uxmanager) helps you to manage the appearance features in Luigi, such as the behavior of backdrop or loading indictors.

docs/authorization-configuration.md

@@ -1,4 +1,4 @@
-# Authorization Configuration
+# Authorization configuration
 
 Luigi provides OpenID Connect and OAuth2 Implicit Grant authorization out of the box. The **use** key defines the active authorization provider and the **disableAutoLogin** key allows you to disable the automatic login flow that is provided by default.
 

docs/general-settings.md

@@ -1,4 +1,4 @@
-# General Settings
+# General settings
 
 The configuration file also contains a section called **Settings** in which you can configure additional Luigi options.