@saw-mon_and_natalie, thank you for finding the solution for this error and sharing your knowledge here in the community.
In our experience very few people use the LFS locking feature. Because of this, details about LFS locking will not be relevant to most users of the feature and are a potential source of confusion for most people (as they won’t apply to them).
We won’t be adding this to the documentation pages at this time for the reason above. If the frequency of LFS locking use were to change (and LFS locking use were to become the norm instead of the exception), we will revisit this decision.
These considerations regarding the LFS locking feature and Netlify Large Media are now documented in this community topic. This topic is searchable so there is now documentation of a sort - documentation which has been created primarily by you if I’m being honest.
Your suggestions and solutions are detailed, helpfu,l and clear. Thanks to you all that information can be found here now. This is topic the first result returned if you search community for that error (or search Google for that error + “netlify”).
I hope it is clear that we do think this information is important and why we are not updating our documentation at this time (even though it is important).