From c4d8d35b9f065f2a847f2780acb4342dabdfd34c Mon Sep 17 00:00:00 2001
From: Chris Akritidis <43294513+cakrit@users.noreply.github.com>
Date: Thu, 2 Mar 2023 11:21:26 -0800
Subject: [PATCH] Update guidelines.md (#14649)

---
 docs/guidelines.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/guidelines.md b/docs/guidelines.md
index d4414e34a3..6967c00532 100644
--- a/docs/guidelines.md
+++ b/docs/guidelines.md
@@ -54,6 +54,23 @@ Editing documentation locally is the preferred method for completely new documen
 documents. Clone the repository where you wish to make your changes, work on a new branch and create a pull request 
 with that branch. 
 
+### Links to other documents
+
+Please ensure that any links to a different documentation resource are fully expanded URLs to the relevant markdown document,
+not links to learn.netdata.cloud. 
+
+e.g.
+```
+[Correct link to this document](https://github.com/netdata/netdata/blob/master/docs/guidelines.md)
+vs
+[Incorrect link to this document](https://learn.netdata.cloud/XYZ)
+```
+
+This permalink ensures that the link will not be broken by any future restructuring in learn.netdata.cloud.
+
+You can see the URL to the source of any published documentation page in the **Edit this page** link at the bottom. If you 
+just replace `edit` with `blob` in that URL, you have the permalink to the original markdown document.
+
 ### Making a pull request
 
 Pull requests (PRs) should be concise and informative. See our