When it's documented it cannot be changed as easily, so it's often better to not document everything in detail.
Are we seriously having this discussion, HN? Did people just wake up today to what their reality has been for years? https://www.youtube.com/watch?v=ilcRS5eUpwk
You can also tweak this tradeoff a little. If you explain up front that what you're describing changes a lot and don't put it in the official documentation [0], you can be somewhat detailed and still have room to change.
[0]: Think a wiki or blog that your project maintains.