diff --git a/docs/pages/api-reference/client/commit.md b/docs/pages/api-reference/client/commit.md
index 25e0c7b0..55382cdf 100644
--- a/docs/pages/api-reference/client/commit.md
+++ b/docs/pages/api-reference/client/commit.md
@@ -50,9 +50,9 @@ those with matching values. Rules of selection:
 </Expandable>
 
 <Expandable title="backfill" type="bool" defaultVal="True">
-If set to False, Returns error if commit will result in a backfill of any dataset.
-backfill of a dataset is done when there is no existing dataset that is isomorphic to the new dataset.
-backfill parameter can be set as False to prevent accidental backfill.
+If you set the backfill parameter to False, the system will return an error if committing changes would result in a backfill of any dataset/pipeline.
+A backfill occurs when there is no existing dataset that is isomorphic to the new dataset.
+Setting backfill to False helps prevent accidental backfill by ensuring that only datasets matching the existing structure are committed.
 </Expandable>
 
 <pre snippet="api-reference/client/commit#basic" status="success"