Update various docs and comments #2875

Job	Run time
gnumake-clang-tidy-native (c++14, g++)	30s
msvc-msbuild (Debug)	1m 29s
gnumake-clang-tidy-native (c++14, clang++)	29s
msvc-msbuild (Release)	52s
target-arm (am335x)	1m 5s
target-arm-cmake (am335x)	45s
target-arm (bcm2835_raspi_b)	31s
target-arm-macos (am335x)	1m 6s
target-arm-cmake (bcm2835_raspi_b)	1m 0s
target-arm (lpc11c24)	59s
target-arm-macos (bcm2835_raspi_b)	1m 5s
target-arm-cmake (lpc11c24)	1m 31s
target-arm (nxp_imxrt1062)	40s
target-arm-macos (lpc11c24)	52s
target-arm-cmake (nxp_imxrt1062)	29s
target-arm (stm32f100)	44s
target-arm-macos (nxp_imxrt1062)	49s
target-arm-cmake (stm32f100)	43s
target-arm-macos (stm32f100)	52s
target-arm-macos (stm32f407)	52s
target-arm-cmake (stm32f407)	31s
target-arm (stm32f407)	31s
target-arm-macos (stm32f429)	1m 13s
target-arm (stm32f429)	43s
target-arm-cmake (stm32f429)	33s
target-arm-macos (stm32f446)	1m 23s
target-arm (stm32f446)	30s
target-arm-cmake (stm32f446)	1m 15s
target-arm-macos (stm32h7a3)	1m 12s
target-arm (stm32h7a3)	34s
target-avr (avr)	18s
target-arm-cmake (stm32h7a3)	1m 16s
target-arm-macos (stm32l100c)	1m 3s
target-arm (stm32l100c)	31s
target-avr (atmega2560)	31s
target-arm-cmake (stm32l100c)	38s
target-arm-macos (stm32l152)	1m 1s
target-arm (stm32l152)	1m 1s
target-arm-cmake (stm32l152)	44s
target-avr-cmake (avr)	21s
target-avr-macos (avr)	1s
target-host-cmake	27s
target-avr-cmake (atmega2560)	27s
target-riscvfe310 (riscvfe310)	1m 11s
target-avr-macos (atmega2560)	1m 7s
target-x86_64	24s
	36m 49s

Provide feedback