future-others is different than future-you: others are looking for different things, value information density and generally want to get to the point fast.
the delivery team wants different things than the general public.
docs attempting to cover all audiences will do a poor job at all of them: devs/QA aren't happy, customers aren't happy
Know your audience.