diff --git a/readme.md b/readme.md
index dbd82d8..8660dbe 100644
--- a/readme.md
+++ b/readme.md
@@ -1,34 +1,25 @@
 # AllSpice Demos Home
 
-Welcome! We have some great projects to help show you the benefit of AllSpice.
+Welcome! This is our demos home. We have some great projects that will help you understand how your team can use AllSpice and its benefits.
 
-## Altium
-[Altium demo](https://hub.allspice.io/AllSpice-demos/Altium-demo) - Our Altium demo uses the Archimajor 3D printer driver board.
+## Getting started
+These are the best projects to start using AllSpice. We have a basic demo for each of the ECAD tools that we currently support. Feel free to deep dive into the one that fits your team.
 
-### Altium-Libraries
-[AllSpice Altium Library Demo](https://hub.allspice.io/AllSpice-demos/Altium-component-library-demo)
+#### ![ ](https://img.shields.io/badge/-Altium-EEBF3F?labelColor=gray&style=flat&logo=altiumdesigner&link=https://www.altium.com) [Archimajor 3D Printer](https://hub.allspice.io/AllSpice-demos/Altium-demo)
+Our Altium demo uses the Archimajor 3D printer driver board.
 
-[Wurth Altium Library](https://hub.allspice.io/AllSpice-demos/Altium-Component-Library-Wurth)
+#### ![ ](https://img.shields.io/badge/-KiCAD-4183C4?labelColor=gray&style=flat&logo=kicad&link=https://www.kicad.org) [Arduino UNO](https://hub.allspice.io/AllSpice-demos/KiCAD-Arduino-UNO) 
+A clone of the well known Arduino UNO, a microcontroller board based on the ATmega328P designed in KiCAD. 
 
-[Celestial Altium Library](https://hub.allspice.io/AllSpice-demos/Altium-Celestial-library)
-
-### Altium-.gitignore
-[Altium-.gitignore](https://hub.allspice.io/AllSpice-demos/Altium.gitignore)
+#### ![ ](https://img.shields.io/badge/-OrCAD-E35B5B?labelColor=gray&style=flat&link=https://www.cadence.com/en_US/home/tools/pcb-design-and-analysis/orcad.html) [BeagleV Fire ](https://hub.allspice.io/AllSpice-demos/Altium-demo)
+The beagle fire board, an open hardware single-board computer (SBC) powered by the PolarFire microchip MPFS025T.
 
 
-## KiCad
-[KiCad demo](https://hub.allspice.io/AllSpice-demos/KiCAD-Arduino-R3-Demo) - Our KiCad demo features an Arduino R3 board.
 
-## Other file formats
-[PDF demo](https://hub.allspice.io/AllSpice-demos/PDF-demo) - We display PDFs!
+## More Recipes!
 
-## CI/Actions
-
-> :warning: **Warning:** Actions is still WIP. These links are for reference. To learn more, contact support@allspice.io
-> - [Welcome to CI/CD Actions](https://learn.allspice.io/docs/welcome-to-cicd-actions)
-> - [Actions quickstart](https://learn.allspice.io/docs/allspice-cicd-actions-quickstart)
-> - [Actions triggers](https://learn.allspice.io/docs/actions-triggers)
-> - [Actions Demo](https://hub.allspice.io/AllSpice-demos/Actions-Demo)
-
-## Other projects
-[AllSpice Epaper demo](https://hub.allspice.io/AllSpice-demos/AllSpice-epaper-demo)   
\ No newline at end of file
+## Documentation
+For a deep dive explanation on how Allspice works, go to our [Docs](https://learn.allspice.io). Our top suggestions to start are:
+ - [Git 101](https://learn.allspice.io/docs/git-101)
+ - [AllSpice Crash Course](https://learn.allspice.io/docs/allspice-crash-course)
+ - [Design review and merging guide](https://learn.allspice.io/docs/design-reviews-and-merging)