I’m curious as to thoughts regarding documenting intent which cross over with what in my opinion.

Regarding self documenting: I agree, but I also think that means potentially using 5 lines when 1 would do if it makes maintenance more straightforward. This crazy perl one liner makes perfect sense today but not in 3 years.