diff --git a/src/Makefile b/src/Makefile
index c8075236e..75dffb24e 100644
--- a/src/Makefile
+++ b/src/Makefile
@@ -316,6 +316,7 @@ else
     endef
 endif
 
+# Alpine OS doesn't have support for the execinfo backtrace library we use for debug, so we provide an alternate implementation using libwunwind.
 OS := $(shell cat /etc/os-release | grep ID= | head -n 1 | cut -d'=' -f2)
 ifeq ($(OS),alpine)
     FINAL_CXXFLAGS+=-DUNW_LOCAL_ONLY
diff --git a/src/debug.cpp b/src/debug.cpp
index 39a22e297..a9614b61e 100644
--- a/src/debug.cpp
+++ b/src/debug.cpp
@@ -51,6 +51,7 @@ typedef ucontext_t sigcontext_t;
 #include <cxxabi.h>
 #endif /* HAVE_BACKTRACE */
 
+//UNW_LOCAL_ONLY being set means we use libunwind for backtraces instead of execinfo
 #ifdef UNW_LOCAL_ONLY
 #include <libunwind.h>
 #include <cxxabi.h>