chg ! documentation

Author: vitali-yanushchyk-valor

docs/src/.pages

@@ -7,4 +7,6 @@ nav:
   - flows
   - Interfaces: interfaces.md
   - Data cleaning and updates: data_cleaning_updates.md
-  - Import Data: import_data
+  - Data Import: import_data
+  - Data Validation : validation.md
+  - Push Data to HOPE Core: push_data.md

docs/src/index.md

@@ -13,7 +13,7 @@ management process.
 ### Implemented Features
 
 - [Import data](import_data/index.md) from [Kobo](import_data/kobo.md) / [Aurora](import_data/aurora.md) / [XLS](import_data/xls.md) (RDI format)
-- Data validation
+- [Data validation](#validation.md)
 - [Data cleaning and updates](data_cleaning_updates.md)
-- Push data to HOPE
+- [Push data to HOPE](#push_data.md)
 - Export/Amend/Import process

docs/src/push_data.md

@@ -0,0 +1,31 @@
+### Prerequisites
+
+Before pushing data to the HOPE core system, you must [validate](#validation.md) households along with their members.
+
+---
+
+### Processing
+
+##### Navigate to Households
+In the [Collector Interface](interfaces.md#collector-interface), navigate to the menu
+```
+Households
+```
+!!! warning
+    Only beneficiaries not marked as removed are displayed in this interface.
+
+##### Select and Initiate Push
+
+Select the relevant households, choose the **Push to HOPE core** action, and click **[Go]**. This opens a form where you can set the batch options.
+
+
+##### Configure Batch Options
+In the form, you can adjust:
+
+- **Batch Name** – A label for the RDI-to-HOPE batch. This parameter is optional; if omitted, the default value is *"RDI to HOPE " + the current datetime*.
+
+##### Start the Process
+Click **[Push]** to start the process. You will be redirected to the **Jobs** page to monitor the job's progress and details.
+
+##### Post-Push Status
+After a successful push, all households and their members that were sent will be marked as **removed**. To review removed beneficiaries, use the [Admin Interface](interfaces.md#admin-interface).

docs/src/validation.md

@@ -40,10 +40,10 @@ def check_households_validity(self) -> None:
         """
         for hh in self.queryset:
             if not hh.is_valid():
-                self.total["errors"].append(f"HH #{hh.pk} invalid or unvalidated.")
+                self.total["errors"].append(f"HH #{hh.pk} invalid.")
             for ind in hh.members.all():
                 if not ind.is_valid():
-                    self.total["errors"].append(f"Individual #{ind.pk} invalid or unvalidated.")
+                    self.total["errors"].append(f"Ind #{ind.pk} invalid.")
 
     def rdi_create(self) -> None:
         """Create a new RDI record in the external system.