diff --git a/README.md b/README.md
index 3b93171..f8e12d1 100644
--- a/README.md
+++ b/README.md
@@ -1,35 +1,87 @@
-# Atmel SAM: development platform for [PlatformIO](https://platformio.org)
-[![Build Status](https://github.com/platformio/platform-atmelsam/workflows/Examples/badge.svg)](https://github.com/platformio/platform-atmelsam/actions)
+# Atmel SAM [![Badge Status]][Status]
-Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
+*A development platform for **[PlatformIO]**.*
-* [Home](https://registry.platformio.org/platforms/platformio/atmelsam) (home page in the PlatformIO Registry)
-* [Documentation](https://docs.platformio.org/page/platforms/atmelsam.html) (advanced usage, packages, boards, frameworks, etc.)
+
-# Usage
+
-1. [Install PlatformIO](https://platformio.org)
-2. Create PlatformIO project and configure a platform option in [platformio.ini](https://docs.platformio.org/page/projectconf.html) file:
+---
-## Stable version
+[![Button PIO Page]][PIO Page]
+[![Button Documentation]][Documentation]
-```ini
-[env:stable]
-platform = atmelsam
-board = ...
-...
-```
+---
-## Development version
+
-```ini
-[env:development]
-platform = https://github.com/platformio/platform-atmelsam.git
-board = ...
-...
-```
+
+
-# Configuration
+## Supported Architectures
-Please navigate to [documentation](https://docs.platformio.org/page/platforms/atmelsam.html).
+Offers a rich selection of peripherals and features to:
+
+- Flash based products
+
+- ARM based products
+
+ `8KB → 2MB` of flash
+
+ - `Cortex-M0+`
+
+ - `Cortex-M3`
+
+ - `Cortex-M4`
+
+
+
+
+## Usage
+
+1. Install **[PlatformIO]**
+
+2. Create a new project project
+
+3. Configure a platform option in [`/platformio.ini`][Config]
+
+ #### Stable
+
+ ```ini
+ [env:stable]
+ platform = atmelsam
+ board = ...
+ ...
+ ```
+
+ #### Development
+
+ ```ini
+ [env:development]
+ platform = https://github.com/platformio/platform-atmelsam.git
+ board = ...
+ ...
+ ```
+
+
+
+
+
+
+[Documentation]: https://docs.platformio.org/page/platforms/atmelsam.html 'Advanced usage, packages, boards, frameworks, etc.'
+[PlatformIO]: https://platformio.org
+[PIO Page]: https://registry.platformio.org/platforms/platformio/atmelsam 'Home page in the PlatformIO Registry'
+[Status]: https://github.com/platformio/platform-atmelsam/actions
+[Config]: https://docs.platformio.org/page/projectconf.html
+
+
+
+
+[Badge Status]: https://github.com/platformio/platform-atmelsam/workflows/Examples/badge.svg
+
+
+
+
+[Button Documentation]: https://img.shields.io/badge/Documentation-3884FF?style=for-the-badge&logoColor=white&logo=GitBook
+[Button PIO Page]: https://img.shields.io/badge/PlatformIO-ff7f00?style=for-the-badge&logoColor=white&logo=AzureArtifacts