diff --git a/README.md b/README.md
index 53721ba0417dbf2c3ed616f3b14717c2496f8034..8619251b59d0278d39f06e82fa0fd5ee9260f67e 100644
--- a/README.md
+++ b/README.md
@@ -292,16 +292,16 @@ $changeSet = $table->new(
 );
 ```
 
-The method returns a change set which you can further modify, and eventually save:
+The method returns a change set which you can further modify, and eventually insert:
 
 ```php
 $changeSet->modifyText('Post text');
-$table->save($changeSet);
+$table->insert($changeSet);
 ```
 
 ### Update
 
-To update a record in the table, first you need to get an instance of change set for the specific record. You can get one for any given primary key or row:
+To update a record in the table, you need to get an instance of change set for the specific record. You can get one for any given primary key or row:
 
 ```php
 $changeSet = $table->edit(ArticlePrimaryKey::from($articleId));
@@ -309,11 +309,20 @@ $changeSet = $table->edit(ArticlePrimaryKey::from($articleId));
 $changeSet = $table->edit($articleRow);
 ```
 
-Then you can add modifications to the change set and finally save it:
+You can use named parameters to provide the values to update right within the method call:
+
+```php
+$changeSet = $table->edit(
+    $articleRow,
+    deletedAt: \Brick\DateTime\Instant::now(),
+);
+```
+
+As before, you can also add modifications to the change set afterward, and finally save it:
 
 ```php
 $changeSet->modifyDeletedAt(\Brick\DateTime\Instant::now());
-$table->save($changeSet);
+$table->update($changeSet);
 ```
 
 ### Delete