As promised in the discussion thread, I've opened a PR to clarify the "File System Tables" section and mark it deprecated since there appears to be consensus for at least warning people that this is unsafe in most cases and discouraged.
The PR is here: https://github.com/apache/iceberg/pull/10833 Please vote on this spec change. This will be open for at least 72 hours: [] +1 [] +0 [] -1, do not deprecate File System Tables because . . . -- Ryan Blue
