Merge pull request #455 from weaviate/docs/clarify-revectorize-check-disabled

docs: clarify REVECTORIZE_CHECK_DISABLED env var description

Author: g-despot

docs/deploy/configuration/env-vars/index.md

@@ -100,7 +100,7 @@ import APITable from '@site/src/components/APITable';
 | `QUERY_SLOW_LOG_ENABLED` | Log slow queries for debugging. Requires a restart to update. | `boolean` | `False` |
 | `QUERY_SLOW_LOG_THRESHOLD` | Set a threshold time for slow query logging. Requires a restart to update. | `string` | `2s` <br/> Values are times: `3h`, `2s`, `100ms` |
 | `REINDEX_SET_TO_ROARINGSET_AT_STARTUP` | Allow Weaviate to perform a one-off re-indexing to use Roaring Bitmaps. | `boolean` | `true` |
-| `REVECTORIZE_CHECK_DISABLED` | Disables the optimization where Weaviate checks if a vector can be reused from a previous version of the object. When disabled, improves write throughput by eliminating read-before-write patterns for new objects. Default: `false` | `boolean` | `false` |
+| `REVECTORIZE_CHECK_DISABLED` | Disables the optimization that reuses an object's existing vector when it is updated and none of its vectorized properties changed. By default (`false`) this check runs and skips unnecessary re-vectorization; set to `true` to re-vectorize on every update. Disabling removes a read-before-write — which can raise write throughput, or force always-fresh vectors — at the cost of an extra embedding call (and API cost, for remote vectorizers) per update. Default: `false` | `boolean` | `false` |
 | `TENANT_ACTIVITY_READ_LOG_LEVEL` | Sets the log level for tenant read activity. Useful for analysis or debugging purposes. Default: `debug` | `string` | `info` |
 | `TENANT_ACTIVITY_WRITE_LOG_LEVEL` | Sets the log level for tenant write activity. Useful for analysis or debugging purposes. Default: `debug` | `string` | `info` |
 | `TOKENIZER_CONCURRENCY_COUNT` | Limit the combined number of GSE and Kagome tokenizers running at the same time. Default: `GOMAXPROCS` | `string - number` | `NUMBER_OF_CPU_CORES` |