diff --git a/CMakeLists.txt b/CMakeLists.txt
index 88e9d1d1..d2da0f6a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -5,6 +5,7 @@ if(ltoresult)
 set(CMAKE_INTERPROCEDURAL_OPTIMIZATION TRUE)
 endif()
 
+# usage: cmake -DSIMDJSON_DISABLE_AVX=on ..
 option(SIMDJSON_DISABLE_AVX "Forcefully disable AVX even if hardware supports it" OFF)
 	
 set(CMAKE_CXX_STANDARD 17)
diff --git a/Makefile b/Makefile
index a99cf7b0..e9edf55a 100644
--- a/Makefile
+++ b/Makefile
@@ -13,6 +13,7 @@ architecture:=$(shell arch)
 ####
 # If you want to specify your own target architecture,
 # then define ARCHFLAGS. Otherwise, we set good default.
+# E.g., type ' ARCHFLAGS="-march=nehalem" make parse '
 ###
 ifeq ($(architecture),aarch64)
 ARCHFLAGS ?= -march=armv8-a+crc+crypto