Drop misleading field-ID rationale from docs

Author: smaheshwar-pltr

mkdocs/docs/api.md

@@ -201,7 +201,7 @@ new_schema = Schema(
 catalog.replace_table(identifier="docs_example.bids", schema=new_schema)
 ```
 
-Field IDs from columns whose names appear in the previous schema are reused, so existing data files remain readable when the new schema is a compatible superset. New columns get fresh IDs above `last-column-id`.
+Field IDs are reused by name from the previous schema; new columns get fresh IDs above `last-column-id`.
 
 Properties passed to `replace_table` are **merged** with the existing table properties (your values override; existing keys you don't pass are preserved). To remove a property as part of the replace, use `replace_table_transaction` and remove it explicitly within the transaction.