From 5e1b2dbfe948d5c4af7a78220fe88071c6c00147 Mon Sep 17 00:00:00 2001
From: Shashank2125 <138694950+Shashank2125@users.noreply.github.com>
Date: Mon, 27 Oct 2025 20:45:50 +0530
Subject: [PATCH] Improve Makefile documentation for command flag handling

---
 Makefile | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index e48e9d7..d70dfad 100644
--- a/Makefile
+++ b/Makefile
@@ -3,7 +3,16 @@ SHELL := /usr/bin/env bash
 IMAGE := igel
 VERSION := latest
 
-#! An ugly hack to create individual flags
+#-----------------------------------------------------------------------
+#Conditional configuration for tool command flags
+#
+#When STRICT=1, all tools run in strict mode(no dash prefix)
+#When STRICT is unset, dash-prefixed flags(-) are used to disable strict checks
+#This approach ensures comaptibility across Poetry, Pip, Safety, Bandit, and other tools.
+#
+#Note: Make does not support dynamic variable creation in a portable way,
+#so flags are defined explicitly below clarity
+#------------------------------------------------------------------------
 ifeq ($(STRICT), 1)
 	POETRY_COMMAND_FLAG =
 	PIP_COMMAND_FLAG =