"We need to document macOS"

I spend an inordinate amount of time searching for information about macOS. Whether I am researching the answers for my section in MacFormat magazine, or trying to solve my own problems here, I am also daily reminded of Apple's wholesale failure to provide consistent and complete documentation of its flagship product.The idea you would donate an inordinate amount of time and effort for free to the richest company in the world to perform work they ought to be doing is wholly and completely baffling to me.