address comments

Author: fresh-borzoni

bindings/python/fluss/__init__.pyi

@@ -610,7 +610,8 @@ class TableDescriptor:
         comment: Optional[str] = None,
         log_format: Optional[str] = None,
         kv_format: Optional[str] = None,
-        **properties: str,
+        properties: Optional[Dict[str, str]] = None,
+        custom_properties: Optional[Dict[str, str]] = None,
     ) -> None: ...
     def get_schema(self) -> Schema: ...
 

docs/python-api-reference.md

@@ -158,7 +158,7 @@ Supports `with` statement (context manager).
 
 | Method | Description |
 |---|---|
-| `TableDescriptor(schema, *, partition_keys=None, bucket_count=None, bucket_keys=None, comment=None, **properties)` | Create table descriptor |
+| `TableDescriptor(schema, *, partition_keys=None, bucket_count=None, bucket_keys=None, comment=None, log_format=None, kv_format=None, properties=None, custom_properties=None)` | Create table descriptor |
 | `.get_schema() -> Schema` | Get the schema |
 
 ## `TablePath`

docs/python-client.md

@@ -154,6 +154,10 @@ await admin.drop_table(table_path, ignore_if_not_exists=True)
 | `bucket_count` | Number of buckets (parallelism units) for the table |
 | `bucket_keys` | Columns used to determine bucket assignment |
 | `comment` | Table comment / description |
+| `log_format` | Log storage format: `"ARROW"` or `"INDEXED"` |
+| `kv_format` | KV storage format for primary key tables: `"INDEXED"` or `"COMPACTED"` |
+| `properties` | Table configuration properties as a dict (e.g. `{"table.replication.factor": "1"}`) |
+| `custom_properties` | User-defined properties as a dict |
 
 ### Offsets