> Just like code should be primarily written for humans to read, all files in a repository is written primarily for humans to review

The author at least acknowledges the point of files is to be read by humans.

Also the article is talking specifically about public docs mean to be used by others, not ones you’re specifically trying to keep private