Documentation is hard because you have to have empathy for the user while holding most of the product's capabilities in your head while you write it. Transfer o

Documentation is hard because you have to have empathy for the user while holding most of the product's capabilities in your head while you write it. Transfer of knowledge has always been difficult, and when you start changing the rules in the middle of trying to explain how it works, you'll end up with a very large challenge. I would assume they'll eventually figure it out and improve it. Until then, the best thing to do is dig, dig, dig.