Sharpen properties-merge note in replace docs

Author: smaheshwar-pltr

mkdocs/docs/api.md

@@ -203,7 +203,7 @@ catalog.replace_table(identifier="docs_example.bids", schema=new_schema)
 
 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.
+Unlike the other fields, table properties are *merged* on replace: properties you don't pass are preserved on the table. To remove a property as part of the replace, use `replace_table_transaction` and drop it explicitly within the transaction.
 
 Use `replace_table_transaction` to stage additional changes (writes, property updates, schema evolution) before committing — for example, swap the schema and write new data atomically: