diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
index c141541a9..4a93d58d9 100644
--- a/docs/.vuepress/config.js
+++ b/docs/.vuepress/config.js
@@ -25,7 +25,7 @@ const docsSidebar = [
title: 'Overview',
collapsable: true,
children: [
- ['/overview/architecture', 'LDK Architecture'],
+ ['/overview/architecture', 'Architecture'],
['/overview/persistent_storage', 'Persistent Storage'],
['/overview/blockchain_data', 'Blockchain Data'],
['/overview/wallet_management', 'Wallet Management'],
@@ -184,7 +184,7 @@ module.exports = {
link: '/running-a-sample-ldk-node/'
},
{
- text: 'LDK Architecture',
+ text: 'Architecture',
link: '/overview/architecture/'
},
{
diff --git a/docs/assets/ldk-architecture.svg b/docs/assets/ldk-architecture.svg
index 2427a8f7d..9f9b83111 100644
--- a/docs/assets/ldk-architecture.svg
+++ b/docs/assets/ldk-architecture.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/introduction/index.md b/docs/introduction/index.md
index 93f90229a..adea2a819 100644
--- a/docs/introduction/index.md
+++ b/docs/introduction/index.md
@@ -29,7 +29,7 @@ provide a useful overview of Rust Lightning in the context of language bindings.
The sample serves as a complete reference for constructing a Lightning node with
the LDK. This is a good starting point if you want a self-guided tour!
-### [LDK Architecture](../overview/architecture)
+### [Architecture](../overview/architecture)
Gives a high-level organization of LDK and how the pieces fit together. Variations of this diagram
are used throughout the site. This is the primary source and is still a work in progress.
\ No newline at end of file
diff --git a/docs/overview/architecture.md b/docs/overview/architecture.md
index 811b3f3b2..ffb92f1a9 100644
--- a/docs/overview/architecture.md
+++ b/docs/overview/architecture.md
@@ -1,10 +1,12 @@
-## LDK Architecture
-
+# Architecture
+
-LDK's core components are shown in the center box labeled `lightning`. The boxes
-with dotted borders are LDK's modules — these must be configured with either
-off-the-shelf or custom implementations that you provide.
+Firstly, LDK is not a daemon, but rather its own implementation of the Lightning protocol written as an SDK and designed to be compiled and executed in your application.
-`EventHandler` in the diagram is not so much a necessary LDK module, but instead
-refers to the fact that LDK generates events that the user should handle (e.g.
-the `PaymentReceived` event).
+This makes it environment agnostic, allowing you to choose your own data storage, wallet, networking stack and blockchain monitoring. In the diagram above the boxes with dotted borders are LDK's modules — these must be configured with either default or custom implementations that you provide.
+
+LDK also uses an event-driven architecture which allows for asynchronous result notification. For example you perform actions like making payments without waiting for the result and are later made aware via an event if the payment was successful or not.
+
+::: tip Langauge Bindings
+
+Although the core SDK is written in Rust, LDK supports many other programming languages. These include Java/Kotlin, Swift, JavaScript/TypeScript (Beta), C++ (Alpha). Check out [examples](../examples.md) to see some of the implementations out in the wild!