::migrate:: add comment

.github/workflows/migrate.yaml

@@ -15,6 +15,15 @@ permissions:
 
 jobs:
   migrate:
+    # This workflow is triggered only on pushes to the `main`, `*.staging` or 'migrate' branches.
+    # For `*.staging` and `migrate` it specifically checks if the commit message starts with `::migrate::`,
+    # indicating a migration-related change.
+    #
+    # Example usage:
+    #   Execute a commit with a migration flag using:
+    #   git commit --allow-empty -m "::migrate::test description"
+    # Note:
+    #   This setup is a temporary measure. The intention is to transition to a fully automated publish and release process via GitHub Actions in the future.
     if: (github.ref_name == 'main') || ((github.ref_name == 'migrate' || endsWith(github.ref_name, '.staging')) && startsWith(github.event.head_commit.message, '::migrate::'))
 
     runs-on: ubuntu-latest