diff --git a/README.md b/README.md
index 63743a456f4c8f8561bbeee8c59d63b88d352285..0b1d3b6084a0a4b3ebcbb4b88790917810d0cf73 100644
--- a/README.md
+++ b/README.md
@@ -1,81 +1,84 @@
-> NOTE: We have recently made significant changes to our repository structure. In order to streamline our development
-process and foster better contributions, we have merged three separate repositories Cumulus, Substrate and Polkadot into
-this repository. Read more about the changes [
-here](https://polkadot-public.notion.site/Polkadot-SDK-FAQ-fbc4cecc2c46443fb37b9eeec2f0d85f).
+
+<div align="center">
# Polkadot SDK
-
+<picture>
+ <source media="(prefers-color-scheme: dark)" srcset="docs/images/Polkadot_Logo_Horizontal_Pink_White.png">
+ <source media="(prefers-color-scheme: light)" srcset="docs/images/Polkadot_Logo_Horizontal_Pink_White.png">
+</picture>
+
-[](https://substrate.stackexchange.com/)
+ 
-The Polkadot SDK repository provides all the resources needed to start building on the Polkadot network, a multi-chain
-blockchain platform that enables different blockchains to interoperate and share information in a secure and scalable
-way. The Polkadot SDK comprises three main pieces of software:
+[](https://substrate.stackexchange.com/)  
-## [Polkadot](./polkadot/)
-[](https://forum.polkadot.network/)
-[](./polkadot/LICENSE)
+
+
-Implementation of a node for the https://polkadot.network in Rust, using the Substrate framework. This directory
-currently contains runtimes for the Westend and Rococo test networks. Polkadot, Kusama and their system chain runtimes
-are located in the [`runtimes`](https://github.com/polkadot-fellows/runtimes/) repository maintained by
-[the Polkadot Technical Fellowship](https://polkadot-fellows.github.io/dashboard/#/overview).
+> The Polkadot SDK repository provides all the components needed to start building on the
+> [Polkadot](https://polkadot.network) network, a multi-chain blockchain platform that enables
+> different blockchains to interoperate and share information in a secure and scalable way.
-## [Substrate](./substrate/)
- [](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/substrate/index.html)
- [](./substrate/README.md#LICENSE)
+</div>
-Substrate is the primary blockchain SDK used by developers to create the parachains that make up the Polkadot network.
-Additionally, it allows for the development of self-sovereign blockchains that operate completely independently of
-Polkadot.
+## 📚 Documentation
-## [Cumulus](./cumulus/)
-[](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/cumulus/index.html)
-[](./cumulus/LICENSE)
+* [🦀 rust-docs]([paritytech.github.io/](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/index.html))
+ * [Introduction](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/index.html)
+ to each component of the Polkadot SDK: Substrate, FRAME, Cumulus, and XCM
+* Other Resources:
+ * [Polkadot Wiki -> Build](https://wiki.polkadot.network/docs/build-guide)
-Cumulus is a set of tools for writing Substrate-based Polkadot parachains.
+## 🚀 Releases
-## Releases
+> [!NOTE]
+> Our release process is still Work-In-Progress and may not yet reflect the aspired outline
+> here.
-> [!NOTE]
-> Our release process is still Work-In-Progress and may not yet reflect the aspired outline here.
+The Polkadot-SDK has two release channels: `stable` and `nightly`. Production software is advised to
+only use `stable`. `nightly` is meant for tinkerers to try out the latest features. The detailed
+release process is described in [RELEASE.md](docs/RELEASE.md).
-The Polkadot-SDK has two release channels: `stable` and `nightly`. Production software is advised to only use `stable`.
-`nightly` is meant for tinkerers to try out the latest features. The detailed release process is described in
-[RELEASE.md](docs/RELEASE.md).
+### 😌 Stable
-### Stable
+`stable` releases have a support duration of **three months**. In this period, the release will not
+have any breaking changes. It will receive bug fixes, security fixes, performance fixes and new
+non-breaking features on a **two week** cadence.
-`stable` releases have a support duration of **three months**. In this period, the release will not have any breaking
-changes. It will receive bug fixes, security fixes, performance fixes and new non-breaking features on a **two week**
-cadence.
+### 🤠Nightly
-### Nightly
+`nightly` releases are released every night from the `master` branch, potentially with breaking
+changes. They have pre-release version numbers in the format `major.0.0-nightlyYYMMDD`.
-`nightly` releases are released every night from the `master` branch, potentially with breaking changes. They have
-pre-release version numbers in the format `major.0.0-nightlyYYMMDD`.
+## 🔠Security
-## Upstream Dependencies
+The security policy and procedures can be found in
+[docs/contributor/SECURITY.md](./docs/contributor/SECURITY.md).
-Below are the primary upstream dependencies utilized in this project:
+## 🤠Contributing & Code of Conduct
-- [`parity-scale-codec`](https://crates.io/crates/parity-scale-codec)
-- [`parity-db`](https://crates.io/crates/parity-db)
-- [`parity-common`](https://github.com/paritytech/parity-common)
-- [`trie`](https://github.com/paritytech/trie)
+Ensure you follow our [contribution guidelines](./docs/contributor/CONTRIBUTING.md). In every
+interaction and contribution, this project adheres to the [Contributor Covenant Code of
+Conduct](./docs/contributor/CODE_OF_CONDUCT.md).
-## Security
+### 👾 Ready to Contribute?
-The security policy and procedures can be found in [docs/contributor/SECURITY.md](./docs/contributor/SECURITY.md).
+Take a look at the issues labeled with [`mentor`](https://github.com/paritytech/polkadot-sdk/labels/C1-mentor) (or alternatively [this](https://mentor.tasty.limo/) page, created by one of
+the maintainers) label to get started! We always recognize valuable contributions by proposing an
+on-chain tip to the Polkadot network as a token of our appreciation.
-## Contributing & Code of Conduct
+## Polkadot Fellowship
-Ensure you follow our [contribution guidelines](./docs/contributor/CONTRIBUTING.md). In every interaction and
-contribution, this project adheres to the [Contributor Covenant Code of Conduct](./docs/contributor/CODE_OF_CONDUCT.md).
+Development in this repo usually goes hand in hand with the `fellowship` organization. In short,
+this repository provides all the SDK pieces needed to build both Polkadot and its parachains. But,
+the actual Polkadot runtime lives in the `fellowship/runtimes` repository. Read more about the
+fellowship, this separation, the RFC process
+[here](https://polkadot-fellows.github.io/dashboard/).
-## Additional Resources
+## History
-- For monitoring upcoming changes and current proposals related to the technical implementation of the Polkadot network,
- visit the [`Requests for Comment (RFC)`](https://github.com/polkadot-fellows/RFCs) repository. While it's maintained
- by the Polkadot Fellowship, the RFC process welcomes contributions from everyone.
+This repository is the amalgamation of 3 separate repositories that used to make up Polkadot SDK,
+namely Substrate, Polkadot and Cumulus. Read more about the merge and its history
+[here](https://polkadot-public.notion.site/Polkadot-SDK-FAQ-fbc4cecc2c46443fb37b9eeec2f0d85f).
diff --git a/docs/images/Polkadot_Logo_Horizontal_Pink_Black.png b/docs/images/Polkadot_Logo_Horizontal_Pink_Black.png
new file mode 100644
index 0000000000000000000000000000000000000000..8909dc96a62a93f2bd8b9204e3f1a6885dffae52
Binary files /dev/null and b/docs/images/Polkadot_Logo_Horizontal_Pink_Black.png differ
diff --git a/docs/images/Polkadot_Logo_Horizontal_Pink_White.png b/docs/images/Polkadot_Logo_Horizontal_Pink_White.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea814ea28d5c813613c087f0a2fe0e3e1f8f4b52
Binary files /dev/null and b/docs/images/Polkadot_Logo_Horizontal_Pink_White.png differ
diff --git a/docs/mermaid/IA.mmd b/docs/mermaid/IA.mmd
index 4eb50bcf96a8932de3fa90748fcfeb3ca7f02a5f..fe9a96bcafc0053c18332ca5901a93142811977f 100644
--- a/docs/mermaid/IA.mmd
+++ b/docs/mermaid/IA.mmd
@@ -1,5 +1,6 @@
flowchart
parity[paritytech.github.io] --> devhub[polkadot_sdk_docs]
+ polkadot[polkadot.network] --> devhub[polkadot_sdk_docs]
devhub --> polkadot_sdk
devhub --> reference_docs
@@ -10,5 +11,3 @@ flowchart
polkadot_sdk --> cumulus
polkadot_sdk --> polkadot
polkadot_sdk --> xcm
-
-
diff --git a/docs/sdk/src/polkadot_sdk/polkadot.rs b/docs/sdk/src/polkadot_sdk/polkadot.rs
index 61a6877696cb9298ed831562923d96d4a701bcc4..e2dcca4dc7dfcd2726d24b9f7725a67bad50246b 100644
--- a/docs/sdk/src/polkadot_sdk/polkadot.rs
+++ b/docs/sdk/src/polkadot_sdk/polkadot.rs
@@ -6,14 +6,16 @@
//!
//! - [Polkadot Forum](https://forum.polkadot.network/)
//! - [Polkadot Parachains](https://parachains.info/)
-//! - [Polkadot (multi-chain) Explorer](https://subscan.io/)
+//! - [Polkadot (multi-chain) Explorer: Subscan](https://subscan.io/)
//! - Polkadot Fellowship
//! - [Manifesto](https://github.com/polkadot-fellows/manifesto)
//! - [Runtimes](https://github.com/polkadot-fellows/runtimes)
//! - [RFCs](https://github.com/polkadot-fellows/rfcs)
+//! - [Dashboard](https://polkadot-fellows.github.io/dashboard/)
//! - [Polkadot Specs](spec.polkadot.network)
//! - [The Polkadot Parachain Host Implementers' Guide](https://paritytech.github.io/polkadot-sdk/book/)
//! - [Whitepaper](https://www.polkadot.network/whitepaper/)
+//! - [JAM Graypaper](https://graypaper.com)
//!
//! ## Alternative Node Implementations 🌈
//!