docs: Improve clarity and consistency in pending review documentation

Author: dt2patel

documents/retail-operations/inventory/cycle-count/pending-review.md

@@ -1,227 +1,210 @@
-# Pending Review
+# Pending review
 
 ## Pending review page
 
-This manual provides a step-by-step guide to understanding and using the Pending Review sections in the Cycle Count App, helping admins review all submitted counts before they are finalized and guiding them on how to navigate the page, interpret the information displayed, and perform review actions smoothly.
+Use the `Pending review` section in the Cycle Count app to review submitted counts before they are finalized. This page lists inventory counts completed by store associates that are waiting for admin review so you can check variances, validate accuracy, and take action.
 
-This manual provides a step-by-step guide to understanding and using the Pending Review sections in the Cycle Count App, helping admins review all submitted counts before they are finalized. It lists all inventory counts completed by store associates that are waiting for admin review. From here, admins can check variances, validate accuracy, and take necessary review actions.
+## Required permissions
 
-## Required Permissions
+* `COMMON_ADMIN`: Grants access to view pending cycle counts, review submitted counts, accept or reject items, and close counts.
 
-To access and use the Pending Review page, users must have the following permission:
+### Search and filter counts
 
-* `COMMON_ADMIN` - This permission grants access to view pending cycle counts, review submitted counts, accept or reject items, and close counts.
+#### Search
 
-Without this permission, users will not be able to access the Pending Review section or perform any review actions.
+Use the search bar to find a specific count by name or ID.
 
-### Search and Filter Counts
+#### Filter by type
 
-1. Search  
-     
-   Admins can use the search bar to quickly find a specific count by entering the count name or ID.
+Filter pending counts by inventory count type:
 
-2. Filter by Type  
-     
-   Admins can filter pending counts based on the type of inventory count. Types include:  
-   * Hard Count  
-   * Directed Count  
-       
-3. Filter by Facility  
-     
-   This filter allows the admin to view counts submitted by a specific store or warehouse. For instance, selecting Brooklyn will display only the counts completed at that location.  
-   
+* `Hard count`  
+* `Directed count`
 
-Both Filter by Type and Filter by Facility filters can be combined to refine the results further.
+#### Filter by facility
 
-### Viewing Count Details
+Filter by store or warehouse to see counts submitted at a specific location (for example, Brooklyn). Combine facility and type filters to refine results further.
+
+### Viewing count details
 
 Each item in the list represents one cycle count and displays the following details:
 
-* Count Type: Indicates the type of inventory count submitted by the store team.  
-* Count Name: A user-assigned name that identifies the count.   
-* Facility Name: Specifies the facility where the inventory count was performed.  
-* Created Date: Shows when the count was initially created.   
-* Due Date: Indicates the deadline for completing the count.
+* Count type: Indicates the type of inventory count submitted by the store team.  
+* Count name: A user-assigned name that identifies the count.   
+* Facility name: Specifies the facility where the inventory count was performed.  
+* Created date: Shows when the count was initially created.   
+* Due date: Indicates the deadline for completing the count.
 
 For example:
 
-A Hard Count named 03 December Count created on 3rd Dec 2025 at Brooklyn will appear as a row on this page.
+A `Hard count` named 03 December Count created on 3 Dec 2025 at Brooklyn appears as a row on this page.
 
-Admins can click on any count card to open the detailed review screen.
+Admins can click any count card to open the detailed review screen.
 
-## Review Count Page Overview
+## Review count page overview
 
 This page is used by admins to review the inventory counts submitted by store associates. It highlights mismatches between the counted quantity and system inventory, giving the admin full control to approve or reject each item.
 
-### Page Header Information
+### Page header information
 
 At the top of the page, you will find key details about the count:
 
-**Count Information**
+**Count information**
 
-* Count Name – The name of the count (e.g., 26 December Count).  
-* Facility Name: The facility where the inventory count was performed.  
-* Start Date – When the store was supposed to start the count.  
-* Due Date – The scheduled completion date.  
-* First Item Counted – Timestamp of when counting began.  
-* Last Item Counted – Timestamp of when the last item was counted.
+* Count name – The name of the count (for example, 26 December Count).  
+* Facility name – The facility where the inventory count was performed.  
+* Start date – When the store was supposed to start the count.  
+* Due date – The scheduled completion date.  
+* First item counted – Timestamp of when counting began.  
+* Last item counted – Timestamp of when the last item was counted.
 
-**Review Progress**
+**Review progress**
 
 * Shows the percentage of items reviewed.  
 * Displays how many items have been reviewed out of the total.
 
-**Overall Variance (Filtered)**
+**Overall variance (filtered)**
 
 This metric shows the total variance across all filtered items in the current count. Variance means the difference between what was physically counted and what the system expected. 
 
-**Example shown:**
+**Example:**
 
 * 90 units of variance  
 * Based on 10 results
 
 
 This means that out of the items currently displayed (based on filters applied), the combined difference between counted and system quantities is 90 units across 10 items.
 
-### Search and Filters
+### Search and filters
 
 The section provides search and filtering options to refine the list of items.
 
-**Search Bar**
+**Search bar**
 
 * Allows searching for products by name or SKU.
 
+**Status filter**  
+Filter items by review status:
 
-Status Filter  
-You can filter items based on review status:
-
-* All  
-* Open – Items that need review.  
-* Accepted – Items approved.  
-* Rejected – Items rejected.
+* `All`  
+* `Open` – Items that need review.  
+* `Accepted` – Items approved.  
+* `Rejected` – Items rejected.
 
-### Compliance Filter
+### Compliance filter
 
-The Compliance Filter helps reviewers identify items that fall within or outside the acceptable variance thresholds during a cycle count. 
+The compliance filter helps reviewers identify items that fall within or outside the acceptable variance thresholds during a cycle count. 
 
-**Filter Options**
+**Filter options**
 
-* Acceptable – Shows items whose variance is within the defined threshold.  
-* Rejectable – Shows items whose variance exceeds the threshold.  
-* Configure Threshold – Allows admins to define the acceptable variance limit.
+* `Acceptable` – Shows items whose variance is within the defined threshold.  
+* `Rejectable` – Shows items whose variance exceeds the threshold.  
+* `Configure threshold` – Allows admins to define the acceptable variance limit.
 
 
-**Configure Threshold**  
+**Configure threshold**  
 Admins can configure how much variance is allowed before an item is flagged as out of compliance.
 
-**Admin Options**
+**Admin options**
 
-* Select Unit of Measurement – Choose the basis for calculating variance:  
-    
-  * Units: Compares the difference between counted and system quantities in absolute units   
-  * Percent: Calculates variance as a percentage difference between counted and system quantities  
+* Select unit of measurement – Choose the basis for calculating variance:  
+  * Units: Compares the difference between counted and system quantities in absolute units.  
+  * Percent: Calculates variance as a percentage difference between counted and system quantities.  
   * Cost: Flags variance based on the cost impact of the quantity difference.  
-      
-* Enter Threshold Value – Example: 10 units, 5%, or a cost value depending on the selected unit.  
-    
-* Save Threshold – Click the blue check button to apply the threshold settings.
+* Enter threshold value – Example: 10 units, 5%, or a cost value depending on the selected unit.  
+* Save threshold – Click the blue check button to apply the threshold settings.
 
 
-**How it works (Example)**
+**How it works (example)**
 
 If the threshold is set to **10 units**:
 
-* A product with a variance of 8 is Acceptable  
-* A product with a variance of 25 is Rejectable
+* A product with a variance of 8 is acceptable.  
+* A product with a variance of 25 is rejectable.
 
 
-This allows admins to quickly focus on items with **major mismatches** instead of reviewing every minor deviation.
+This allows admins to quickly focus on items with major mismatches instead of reviewing every minor deviation.
 
-**Sort By**
+**Sort by**
 
 * Sort items alphabetically or by variance.
 
 
-**Item List Section**
+**Item list section**
 
-The **Item List** displays all items included in a count event, along with their relevant details and actions for review.
+The item list displays all items included in a count event, along with their relevant details and actions for review.
 
-**Item Row Details**  
+**Item row details**  
 Each item row contains the following information:
 
-1. **Product Details**  
+1. **Product details**  
 
-* Product Image – Visual representation of the product.  
-* SKU and Name – SKU and the product name.  
+* Product image – Visual representation of the product.  
+* SKU and name – SKU and the product name.  
 
-2. **Count Information**  
+2. **Count information**  
 
-* Counted Quantity / System Quantity – Shows the quantity counted versus the system-recorded quantity.
-
-* Variance Value – The difference between the counted and system quantity.  
+* `Counted quantity` / `System quantity` – Shows the quantity counted versus the system-recorded quantity.  
+* `Variance` – The difference between the counted and system quantity.  
 
 3. **Actions**  
 
-* ACCEPT – Approve the counted quantity.  
-* REJECT – Reject the count and send the item for recount.
+* `Accept` – Approve the counted quantity.  
+* `Reject` – Reject the count and send the item for recount.
 
 Note: Bulk actions can be applied when multiple items are selected using the checkboxes.
 
-### Bulk Review Actions
+### Bulk review actions
 
 At the top of the item list, you can perform bulk actions for all selected items:
 
-* ACCEPT – Accepts the counted quantities of selected items.  
-* REJECT – Rejects selected items and sends them for recount.  
+* `Accept` – Accepts the counted quantities of selected items.  
+* `Reject` – Rejects selected items and sends them for recount.  
 
   Clicking these buttons will apply the chosen action to all selected rows simultaneously.
 
-### Additional Information (Expanded View)
+### Additional information (expanded view)
 
 When you click on an item row, it expands to display additional details:
 
 1. **Count details**  
 
-   * Count Name – The name of the count.  
-   * Count Performed By – The user who performed the count.  
-   * Total Quantity Counted – The total counted quantity for the item.  
+   * Count name – The name of the count.  
+   * Count performed by – The user who performed the count.  
+   * Total quantity counted – The total counted quantity for the item.  
    * Timestamps – Time when counting started and when it was last updated.  
 
 2. **More options**  
 
-   * Last Counted – Displays the last counted quantity for the item.  
-   * Edit Count – Allows editing the counted quantity if adjustments are needed.  
-   * Remove Count – Removes the current count for the item.  
+   * Last counted – Displays the last counted quantity for the item.  
+   * Edit count – Allows editing the counted quantity if adjustments are needed.  
+   * Remove count – Removes the current count for the item.  
 
 
-Items that have already been reviewed and accepted display an “APPLIED” status, indicating that the final counted quantity has been successfully submitted to the system.
+Items that have already been reviewed and accepted display an `Applied` status, indicating that the final counted quantity has been submitted to the system.
 
-### Closing the Review
+### Closing the review
 
-Once the admin has finished reviewing all items in the count, they can use the Close Count button to finalize the cycle count. Closing a count means that the admin has reviewed all variances and is ready to complete the process.
+Once the admin has finished reviewing all items in the count, they can use the `Close count` button to finalize the cycle count. Closing a count means the admin has reviewed all variances and is ready to complete the process.
 
-When the admin clicks the Close button, the system opens a confirmation modal with two options:
+When the admin clicks `Close count`, the system opens a confirmation modal with two options:
 
-Options Available While Closing a Count
+**Options when closing a count**
 
 1. Accept all outstanding variances and close  
-     
-* This option automatically accepts all remaining items that were not manually accepted or rejected.  
-* Useful when the admin is confident that the remaining variances are correct.  
-* Example: If 3 items are still open and the admin wants to approve them all at once, selecting this option completes the review quickly.
-
+   * Automatically accepts all remaining items that were not manually accepted or rejected.  
+   * Useful when the admin is confident the remaining variances are correct.  
+   * Example: If three items are still open and the admin wants to approve them at once, selecting this option completes the review quickly.
 
 2. Reject all outstanding variances and close  
-     
-* This option automatically rejects all remaining open variances.  
-* Useful when the admin wants those items to be recounted or corrected later.  
-* Example: If several items show unusual variances, the admin can reject all of them in one action.
-
+   * Automatically rejects all remaining open variances.  
+   * Useful when the admin wants those items to be recounted or corrected later.  
+   * Example: If several items show unusual variances, the admin can reject all of them in one action.
 
 Closing the cycle count ensures that the cycle count lifecycle is completed and that the inventory updates are accurately reflected in the system.
 
-**After Closing the Count**
+**After closing the count**
 
-* The count moves from the Pending Review section to the Closed section.  
-* This means the review is fully completed and no further changes can be made.  
-* The system will now post adjustments based on the accepted items.
+* The count moves from the `Pending review` section to the `Closed` section.  
+* The review is fully completed and no further changes can be made.  
+* The system posts adjustments based on the accepted items.