diff --git a/Makefile b/Makefile
index bbf0d18..086e94d 100644
--- a/Makefile
+++ b/Makefile
@@ -31,10 +31,12 @@ include $(top_builddir)/src/Makefile.global
 include $(top_srcdir)/contrib/contrib-global.mk
 endif
 
-
+# Fetches typedefs list for PostgreSQL core and merges it with typedefs defined in this project.
+# https://wiki.postgresql.org/wiki/Running_pgindent_on_non-core_code_or_development_code
 update-typedefs:
 	wget -q -O - "https://buildfarm.postgresql.org/cgi-bin/typedefs.pl?branch=REL_16_STABLE" | cat - typedefs.list | sort | uniq > typedefs-full.list
 
+# Indents projects sources.
 indent:
 	pgindent --typedefs=typedefs-full.list .