diff --git a/packages/o365/_dev/build/docs/README.md b/packages/o365/_dev/build/docs/README.md
index 8a4631a9e40..6d4a418fe79 100644
--- a/packages/o365/_dev/build/docs/README.md
+++ b/packages/o365/_dev/build/docs/README.md
@@ -1,6 +1,6 @@
 # Microsoft Office 365 Integration
 
-This integration is for Microsoft Office 365. It currently supports user, admin, system, and policy actions and events from Office 365 and Azure AD activity logs exposed by the Office 365 Management Activity API.
+This integration is for [Microsoft Office 365](https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/). It currently supports user, admin, system, and policy actions and events from Office 365 and Azure AD activity logs exposed by the Office 365 Management Activity API.
 
 ## Configuration
 
@@ -12,7 +12,6 @@ To use client-secret authentication, add you secret to the _Client Secret (API k
 
 To use certificate-based authentication, set the paths to the certificate and private key files. If the key file is protected with a passphrase, set this passphrase in the _Private key passphrase_ field. Paths must be absolute and files must exist in the host where _Elastic Agent_ is running.
 
-
 Add your tenant ID(s) to the _Directory (tenant) IDs_ field, then add the hostname that this tenant identifies to the _Directory (tenant) domains_ field. For example:
 - Directory IDs: `my-id-a` `my-id-b`
 - Directory domains: `a.onmicrosoft.com` `b.onmicrosoft.com`
diff --git a/packages/o365/changelog.yml b/packages/o365/changelog.yml
index ea174eb581a..3cb115622f0 100644
--- a/packages/o365/changelog.yml
+++ b/packages/o365/changelog.yml
@@ -1,4 +1,9 @@
 # newer versions go on top
+- version: "1.5.2"
+  changes:
+    - description: Tidy up of Markdown in Readme.md, including adding link to developer's documentation, if missing
+      type: enhancement
+      link: https://github.com/elastic/integrations/pull/3026
 - version: "1.5.1"
   changes:
     - description: Fix processing of ModifiedProperties when it is a list of strings
diff --git a/packages/o365/docs/README.md b/packages/o365/docs/README.md
index c345322f066..d0a2d20bcef 100644
--- a/packages/o365/docs/README.md
+++ b/packages/o365/docs/README.md
@@ -1,6 +1,6 @@
 # Microsoft Office 365 Integration
 
-This integration is for Microsoft Office 365. It currently supports user, admin, system, and policy actions and events from Office 365 and Azure AD activity logs exposed by the Office 365 Management Activity API.
+This integration is for [Microsoft Office 365](https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/). It currently supports user, admin, system, and policy actions and events from Office 365 and Azure AD activity logs exposed by the Office 365 Management Activity API.
 
 ## Configuration
 
@@ -12,7 +12,6 @@ To use client-secret authentication, add you secret to the _Client Secret (API k
 
 To use certificate-based authentication, set the paths to the certificate and private key files. If the key file is protected with a passphrase, set this passphrase in the _Private key passphrase_ field. Paths must be absolute and files must exist in the host where _Elastic Agent_ is running.
 
-
 Add your tenant ID(s) to the _Directory (tenant) IDs_ field, then add the hostname that this tenant identifies to the _Directory (tenant) domains_ field. For example:
 - Directory IDs: `my-id-a` `my-id-b`
 - Directory domains: `a.onmicrosoft.com` `b.onmicrosoft.com`
diff --git a/packages/o365/manifest.yml b/packages/o365/manifest.yml
index ccb1b423ba1..75ea4a8f854 100644
--- a/packages/o365/manifest.yml
+++ b/packages/o365/manifest.yml
@@ -1,6 +1,6 @@
 name: o365
 title: Office 365 Logs
-version: 1.5.1
+version: 1.5.2
 release: ga
 description: Collect and parse event logs from Office 365 with Elastic Agent.
 type: integration