diff --git a/docs/tutorials/manual-knex-rollback.md b/docs/tutorials/manual-knex-rollback.md
index 7a6a57221f..39f01882d4 100644
--- a/docs/tutorials/manual-knex-rollback.md
+++ b/docs/tutorials/manual-knex-rollback.md
@@ -14,7 +14,7 @@ You can interact with Knex running the following in the project root:
 
 ```sh
 # we want to check the migration status
-$ node_modules/.bin/knex  --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/ migrate:status
+$ node_modules/.bin/knex migrate:status --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/
 Using environment: production
 Found 2 Completed Migration file/files.
 20211229105307_init.js
@@ -22,13 +22,13 @@ Found 2 Completed Migration file/files.
 No Pending Migration files Found.
 
 # we want to rollback a specific migration called 20240113144027_assets-namespace.js
-$ node_modules/.bin/knex  --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/ migrate:down 20240113144027_assets-namespace.js
+$ node_modules/.bin/knex migrate:down 20240113144027_assets-namespace.js --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/
 Using environment: production
 Batch 2 rolled back the following migrations:
 20240113144027_assets-namespace.js
 
 # we want to check the migration status to confirm we rolled back the migration
-$ node_modules/.bin/knex  --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/ migrate:status
+$ node_modules/.bin/knex migrate:status --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg --migrations-directory node_modules/@backstage/plugin-catalog-backend/migrations/
 Using environment: production
 Found 1 Completed Migration file/files.
 20211229105307_init.js
@@ -37,13 +37,15 @@ Found 1 Pending Migration file/files.
 
 
 #  running migrations to the current version
-$ node_modules/.bin/knex  migrate:currentVersion --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg
+$ node_modules/.bin/knex migrate:currentVersion --connection "postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@$POSTGRES_HOST/backstage_plugin_app" --client pg
 Using environment: production
 Current Version: 20240113144027
 
 ```
 
-The most common case to use Knex directly is when you want to **rollback a migration** that was applied when you upgraded your Backstage instance and want to downgrade due to some problem. You can use the `migrate:down` command to rollback a specific migration. You can also use the `migrate:rollback` command to rollback the last batch of migrations. This is necessary because Knex will mark migrations as corrupted if you try to downgrade your Backstage instance without the rollback. You are likely to receive a message like this:
+The most common case to use Knex directly is when you want to **rollback a migration** that was applied when you upgraded your Backstage instance and want to downgrade due to some problem. You can use the `migrate:down` command to rollback a specific migration. You can also use the `migrate:rollback` command to rollback the last batch of migrations. This is necessary because Knex will mark migrations as corrupted if you try to downgrade your Backstage instance without the rollback. Be aware to run those commands in the new version of the Backstage instance, so you can avoid the corrupted migrations for lower versions.
+
+You are likely to receive a message like this when you try a downgrade without the rollback:
 
 ```sh
 Backend failed to start up Error: The migration directory is corrupt, the following files are missing: 20230428155633_sessions.js