From b31079a7cfc272149495dd7d6b93afefcce96778 Mon Sep 17 00:00:00 2001
From: Ciro Santilli <ciro.santilli@gmail.com>
Date: Wed, 16 Sep 2020 08:00:07 +0000
Subject: [PATCH] document the highly advanced Makefile

---
 Makefile | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Makefile b/Makefile
index 3b63ba1..0895ae3 100644
--- a/Makefile
+++ b/Makefile
@@ -13,6 +13,11 @@ else
 endif
 
 $(OUT): README.adoc $(HEAD) $(FOOT) template_dir/*
+	@# --embedded + head/foot originally added to fix image height:
+	@# https://stackoverflow.com/questions/63464732/how-to-set-a-custom-image-height-for-an-image-in-asciidoctor
+	@#
+	@# --template-dir initially added for loading="lazy" on images and youtube iframes:
+	@# https://stackoverflow.com/questions/63917971/how-to-create-custom-html-output-for-an-existing-asciidoctor-asciidoc-macro
 	bundle exec asciidoctor \
 		$(MEDIA_CMD) \
 	  --embedded \