From bf4711ecba7947150a73ef2af4eb7898db3f1e9b Mon Sep 17 00:00:00 2001
From: Artem Navoiev <tenmozes@gmail.com>
Date: Fri, 26 May 2023 10:22:29 +0200
Subject: [PATCH] desribe old link param

Signed-off-by: Artem Navoiev <tenmozes@gmail.com>
---
 Makefile | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index b9f1d0223..551c587c7 100644
--- a/Makefile
+++ b/Makefile
@@ -436,7 +436,8 @@ copy-docs:
 
 # Copies docs for all components and adds the order/weight tag, title, menu position and alias with the backward compatible link for the old site.
 # For ORDER=0 it adds no order tag/weight tag.
-# FOR OLD_URL='' it adds no alias.
+# FOR OLD_URL - relative link, used for backward compatibility with the link from documentation based on GitHub pages (old one)
+# FOR OLD_URL='' it adds no alias, it should be empty for every new page, don't change it for already existing links. 
 # Images starting with <img src="docs/ are replaced with <img src="
 # Cluster docs are supposed to be ordered as 2nd.
 # The rest of docs is ordered manually.