adds change long for management command as part of migration

changelog/0079-copy-invitation-supply-point-fields-to-location.yml

@@ -3,18 +3,25 @@ key: copy-invitation-supply-point-fields-to-location
 date: 2024-04-29
 optional_per_env: yes
 # (optional) Min version of HQ that MUST be deployed before this change can be rolled out (commit hash)
-min_commcare_version:
+min_commcare_version: c3f318f328372e904f4b1db42177309211ceb332
 # (optional) Max version of HQ that can be deployed before this change MUST be rolled out (commit hash)
-max_commcare_version:
+max_commcare_version: e8cec378023d635d0d7b765a2476cc8d1be9bb07
 context: |
-  Description of the change.
-  This will be shown as a sort of "preview" in the index.
-  Can be formatted as markdown.
+The `supply_point` field in the `users_invitation` table is queried against the corresponding
+row in the `locations_sqllocation` table, and subsequently copied to the `location_id`
+field in the `users_invitation`.
 
 details: |
-  Details of the change.
-  Can be formatted as markdown.
+  In the `Invitation` model, the `supply_point` field will be replaced by a foreign key reference
+  to `SQLLocation`. This migration is to prepare for that transition.
 
 update_steps: |
-  Steps to update.
-  Can be formatted as markdown.
+  Execute the following command:
+
+  ```shell
+  $ commcare-cloud <env> django-manage --tmux copy_invitation_supply_point
+  ```
+
+  Precautions:
+  * No downtime is needed for this operation however it is best to run the command during a period
+    of low traffic.