diff --git a/casdk-docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg b/casdk-docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg
deleted file mode 100644
index 11bda0928..000000000
Binary files a/casdk-docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg and /dev/null differ
diff --git a/casdk-docs/blog/2021-08-26-welcome/index.md b/casdk-docs/blog/2021-08-26-welcome/index.md
index 1f7f7a658..c0a7943d3 100644
--- a/casdk-docs/blog/2021-08-26-welcome/index.md
+++ b/casdk-docs/blog/2021-08-26-welcome/index.md
@@ -1,15 +1,25 @@
 ---
 slug: welcome
-title: Welcome
-tags: [facebook, hello, docusaurus]
+title: Welcome to the Carbon Aware SDK documentation site
+tags: [welcome,post]
 ---
 
-Welcome to our documentation site!
+Carbon aware software does more when it can leverage greener energy sources, and less when the energy CO2 emissions are higher.  
 
-A blog post folder can be convenient to co-locate blog post images:
+The Carbon Aware SDK is a toolset to help you measure the carbon emissions of your software, in turn helping you **measure and reduce your software's carbon emissions**, and choose when and where you run your software to make it greener.
 
-![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg)
+![Carbon Aware Software](../../docs/images/carbon-aware-software.png)
 
-The blog supports tags as well!
 
-**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.
+By knowing the carbon emissions of the energy that powers your applications, you and your organisation can leverage greener energy sources to reduce your CO2 emissions by:  
+
+* Building  AI models when carbon emissions are lower
+* Deploying software into the cloud in locations that have greener energy sources
+* Running software updates at greener energy time windows 
+* Using data to run hypothetical models to understand how you could start driving impact and reduce emissions, drive business cases for change, and create a greener future. 
+
+Within the [Green Software Foundations Theory of Change](https://greensoftware.foundation/articles/theory-of-change), we look at 3 pillars, that being **Knowledge**, **Tech Culture**, and **Tooling** as focus areas to drive this change.  The Carbon Aware SDK at its core sits firmly in the **Tooling** pillar, and also supports the other pillars, providing **Knowledge** through emissions data to inform change, and being core enabler for the **Tech Culture** for building carbon aware software.
+
+Companies including UBS and Vestas have already deployed the Carbon Aware SDK to build greener software, and you can too!
+
+_Published in feb 2024 based on latest updates to the readme.md_
\ No newline at end of file
diff --git a/casdk-docs/blog/2023-07-18-release-1.1.mdx b/casdk-docs/blog/2023-07-18-release-1.1.mdx
index b25ac4219..1e35e53ac 100644
--- a/casdk-docs/blog/2023-07-18-release-1.1.mdx
+++ b/casdk-docs/blog/2023-07-18-release-1.1.mdx
@@ -54,7 +54,7 @@ Release 1.1
 
 ### Upgrading from 1.0.0 to 1.1.0 
 
-- Configuration changes are required due to historical and forecast configuration now being decoupled.  Refer to - [Configuration](../docs/tutorial-extras/configuration.md) for a guide. The following is provided as an example of the new data source configuration format.
+- Configuration changes are required due to historical and forecast configuration now being decoupled.  Refer to - [Configuration](../docs/tutorial-extras/configuration) for a guide. The following is provided as an example of the new data source configuration format.
 ```json
 {
   "DataSources": {