[IMP] Lunch: Update orders

closes #13632

Signed-off-by: Samuel Lieber (sali) <[email protected]>

Author: larm-odoo

content/applications/hr/lunch/orders.rst

@@ -4,8 +4,11 @@
 Orders
 ======
 
-When the *Lunch* application is opened, the :guilabel:`Order Your Lunch` dashboard loads. This view
-is also accessed by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.
+The **Lunch** app lets employees place lunch orders, see what's available each day, and check their
+account balance, all from one place.
+
+When the **Lunch** application is opened, the :guilabel:`Order Your Lunch` dashboard loads. This
+view is also accessible by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.
 
 The :guilabel:`Order Your Lunch` dashboard provides a summary of lunch offerings, the user's account
 information, and the current day's orders, along with their statuses.
@@ -14,9 +17,9 @@ Order Your Lunch
 ================
 
 On the main :guilabel:`Order Your Lunch` dashboard, all the necessary information needed to place an
-order is visible. The default filter for the products is :guilabel:`Available Today`, which is
-present in the :guilabel:`Search...` bar. This filter shows only products that can be purchased that
-day, based on the :ref:`vendor's availability <lunch/availability>`.
+order is visible. Enable the :guilabel:`Available Today` filter in the search bar by clicking into
+the search bar and selecting :guilabel:`Available Today`. This filter shows only products that can
+be purchased that day, based on the :ref:`vendor's availability <lunch/availability>`.
 
 The left-side of the dashboard displays the various :guilabel:`Categories` of products available,
 along with the :guilabel:`Vendors` supplying the products. To the right of each line is a number,
@@ -38,32 +41,32 @@ view. Each product card displays the name, cost, vendor, photo, and description
 the product is configured as new, it also displays a :guilabel:`New` tag.
 
 .. image:: orders/dashboard.png
-   :align: center
-   :alt: The *Lunch* app dashboard with all areas highlighted.
+   :alt: The Lunch app dashboard.
 
 .. note::
-   Anywhere a vendor's name is listed in the *Lunch* app, such as on Kanban product cards, their
+   Anywhere a vendor's name is listed in the **Lunch** app, such as on Kanban product cards, their
    phone number is listed, as well.
 
-The products can also be displayed in a list view, by clicking the :guilabel:`≣ (four parallel
-lines)` icon in the top-right corner of the dashboard.
+The products can also be displayed in a list view, by clicking the :icon:`oi-view-list`
+:guilabel:`(List)` icon in the top-right corner of the dashboard.
 
 Placing orders
 ==============
 
 To place a lunch order, navigate to the main :guilabel:`Order Your Lunch` dashboard, by either
-opening the *Lunch* app, or by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.
+opening the **Lunch** app, or by navigating to :menuselection:`Lunch app --> My Lunch --> New
+Order`.
 
 Add products to an order
 ------------------------
 
 From the :guilabel:`Order Your Lunch` dashboard, click on a desired product to add to an order, and
 the product appears in a :guilabel:`Configure Your Order` pop-up window.
 
-At the top of the pop-up window is the product image, name, and price. Beneath that, there is a
-potential :guilabel:`Extras` field, showcasing any :ref:`extra items or options <lunch/extras>`.
-Tick the checkbox next to any desired extras present in the :guilabel:`Extras` field to add them to
-the order.
+At the top of the pop-up window is the product image, name, and price. Beneath that, there are
+potential :guilabel:`Extras` fields, showcasing any :ref:`extra items or options <lunch/extras>`,
+such as toppings or drinks. Tick the checkbox next to any desired extras present in the
+:guilabel:`Extras` fields to add them to the order.
 
 Each extra option is organized by a category, complete with its name and price. As extras are
 selected, the displayed price at the top of the pop-up window updates to reflect all current
@@ -77,8 +80,7 @@ When all selections for the product have been made, click the :guilabel:`Add To
 lower-left of the pop-up window. To cancel the order, click the :guilabel:`Discard` button.
 
 .. image:: orders/pizza.png
-   :align: center
-   :alt: The pop-up window for a personal pizza, with all the extras highlighted and selected.
+   :alt: The pop-up window for a personal pizza, with all the extras selected.
 
 Errors
 ~~~~~~
@@ -102,7 +104,6 @@ changes to the :guilabel:`Configure Your Order` pop-up window.
    one and only one Free Beverage with Purchase`.
 
    .. image:: orders/error.png
-      :align: center
       :alt: The :guilabel:`Validation Error` pop-up window with the specific error for the free
             beverage displayed.
 
@@ -121,30 +122,30 @@ The available tags that can be displayed for each item are:
 - :guilabel:`To Order`: the product has been added to the cart, but has not been purchased yet by
   the user.
 - :guilabel:`Ordered`: the product has been purchased by the user, and is waiting to be sent to the
-  vendor by a *Lunch* app manager.
-- :guilabel:`Sent`: the order for the product has been sent to the vendor by a *Lunch* app manager.
+  vendor by a **Lunch** app manager.
+- :guilabel:`Sent`: the order for the product has been sent to the vendor by a **Lunch** app
+  manager.
 - :guilabel:`Received`: the product has been delivered by the vendor to the user's location, and has
-  been verified as received by a *Lunch* app manager.
+  been verified as received by a **Lunch** app manager.
 
-Product quantities can be adjusted by clicking the :guilabel:`➕ (plus sign)` or :guilabel:`➖ (minus
-sign)` to the left of the listed product. The product price adjusts in real-time to display the cost
-for the currently selected quantity of the product.
+Product quantities can be adjusted by clicking the :icon:`fa-plus` :guilabel:`(plus)` or
+:icon:`fa-minus` :guilabel:`(minus)` icons to the left of the listed product. The product price
+adjusts in real-time to display the cost for the currently selected quantity of the product.
 
 The right side of the :guilabel:`Your Order` summary displays the purchasing information. The
 :guilabel:`Total` amount for the entire day's lunch order is displayed. The :guilabel:`Already Paid`
 field indicates how much has been paid that day towards the :guilabel:`Total` amount. The
 :guilabel:`To Pay` field displays how much of the remaining :guilabel:`Total` amount must be paid,
-in order to place the currently configured   order.
+in order to place the currently configured order.
 
 .. image:: orders/your-order.png
-   :align: center
-   :alt: The Your Orders section of the dashboard, with the purchasing information highlighted.
+   :alt: The 'Your Orders' section of the dashboard, with purchasing information.
 
 .. tip::
    Users can place multiple orders throughout the day, and are not restricted to only placing one
    lunch order each day. Multiple orders might need to be placed, due to users forgetting to add
    items to an order, or if there are multiple meals that are available to be purchased for the
-   office ()not just lunch), and so on.
+   office (not only lunch), and so on.
 
    Depending on the various vendors, and how the vendors and products are configured, it is possible
    to order breakfast, lunch, dinner, coffee, and/or snacks.
@@ -154,9 +155,9 @@ Submit an order
 
 To place the order, click the :guilabel:`Order Now` button on the right-side of the :guilabel:`Your
 Order` summary. The user is charged the amount that is displayed in the :guilabel:`To Pay` field,
-and the cost is deducted from their *Lunch* account balance.
+and the cost is deducted from their **Lunch** account balance.
 
-Once the order is placed, the tags for the items just purchased in the :guilabel:`Your Order` field
+Once the order is placed, the tags for the purchased items in the :guilabel:`Your Order` field
 change from orange :guilabel:`To Order` tags to red :guilabel:`Ordered` tags.
 
 Track an order
@@ -171,16 +172,16 @@ green :guilabel:`Received` tags.
 Receive an order
 ----------------
 
-When orders are received at the delivery location, they are confirmed by a *Lunch* app manager, and
-a notification is sent to the employee who ordered the food.
+When orders are received at the delivery location, they are confirmed by a **Lunch** app manager,
+and a notification is sent to the employee who ordered the food.
 
 My Orders
 =========
 
-To view a full list of all orders placed in the *Lunch* app for the currently signed-in user,
+To view a full list of all orders placed in the **Lunch** app for the currently signed-in user,
 navigate to :menuselection:`Lunch app --> My Lunch --> My Order History`. This navigates to the
 :guilabel:`My Orders` dashboard. The data is filtered by :guilabel:`My Orders` and grouped by
-:guilabel:`Order Date: Day`, by default, both of which are located in the :guilabel:`Search...` bar.
+:guilabel:`Order Date: Day`, by default, both of which are located in the search bar.
 
 All products appear in a list view, organized by date. The list displays the :guilabel:`Order Date`,
 :guilabel:`Vendor`, :guilabel:`Product`, :guilabel:`Extras`, :guilabel:`Notes`, :guilabel:`User`,
@@ -202,7 +203,6 @@ applicable. The new order appears in the list, under the current date, and the p
 with money deducted from the user's account.
 
 .. image:: orders/my-orders.png
-   :align: center
    :alt: The list view that appears when navigating to the My Orders dashboard.
 
 My Account
@@ -216,12 +216,10 @@ to oldest. The :guilabel:`Date`, :guilabel:`Description`, and :guilabel:`Amount`
 displayed in the list.
 
 Entries with a negative figure listed in the :guilabel:`Amount` column represent products purchased
-in the *Lunch* app. These appear in a `$-XX.XX` format.
+in the **Lunch** app. These appear in a `$-XX.XX` format.
 
 Entries with a positive balance either represent funds added to the user's lunch account, or
 cancelled orders that were eventually refunded to the user. These appear in a `$XX.XX` format.
 
 .. image:: orders/my-account.png
-   :align: center
-   :alt: The My Account dashboard with the entry for adding funds to the user's lunch account
-         highlighted.
+   :alt: The 'My Account' dashboard with the entry for adding funds to the user's lunch account.