diff --git a/vizro-core/README.md b/vizro-core/README.md
index 3f1027a65..6e1b15ce2 100644
--- a/vizro-core/README.md
+++ b/vizro-core/README.md
@@ -14,11 +14,12 @@
[Documentation](https://vizro.readthedocs.io/en/stable/) | [Get Started](https://vizro.readthedocs.io/en/stable/pages/tutorials/first_dashboard/) | [Vizro examples gallery](http://vizro.mckinsey.com/)
----
+
+
+
-
## What is Vizro?
@@ -29,15 +30,17 @@ Use it to build beautiful and powerful data visualization apps quickly and easil
Then customize and deploy your app to production at scale.
-
-
-Use a few lines of simple low-code configuration, with in-built visual design best practices, to assemble high-quality multi-page prototypes.
+
+
+Use a few lines of simple low-code configuration, with in-built visual design best practices, to assemble high-quality
+multi-page prototypes.
+
The benefits of the Vizro toolkit include:
-
+
Visit ["How-to guides"](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for a more detailed explanation of Vizro features.
@@ -77,7 +80,7 @@ Use Vizro when you need to combine the speed and ease of low-code Python tools,
## How to use Vizro?
-
+
**Low-code framework for building dashboards.**
@@ -89,7 +92,7 @@ Visit the [documentation](https://vizro.readthedocs.io/en/stable/) for more deta
-
+
**Chart examples.**
@@ -101,40 +104,29 @@ Visit the [visual vocabulary](https://vizro-demo-visual-vocabulary.hf.space/) to
-
-
-
+
+
-
- Dashboard examples.
+**Dashboard examples.**
The dashboard examples gallery enables you to explore Vizro in action by viewing interactive example apps. You can copy the code to use as a template or starter for your next dashboard.
-Visit the dashboard examples gallery to see the dashboards in action.
-
-
-
-
-
+Visit the [dashboard examples gallery](https://vizro.mckinsey.com/) to see the dashboards in action.
-
-
-
-
+
+
-
- LLM generated charts and dashboards.
+**LLM generated charts and dashboards.**
Vizro-AI is a separate package (called `vizro_ai`) that extends Vizro to incorporate LLMs. Use it to build interactive Vizro charts and dashboards, by simply describing what you need in plain English or other languages.
-Visit the Vizro-AI documentation for more details.
+Visit the [Vizro-AI documentation](https://vizro.readthedocs.io/projects/vizro-ai/) for more details.
-
-
-
+
+
## Installation and first steps