[IMP] MRP: updated bills of materials rst content

Reviewed the 15.0 doc for Bills of Materials and made some edits to
clean up inconsistencies and made minor wording changes.

closes odoo/documentation#2966

X-original-commit: 1645e8c3da
Signed-off-by: Zachary Straub <zst@odoo.com>

content/applications/inventory_and_mrp/manufacturing/management/alternative_wc.rst

@@ -1,66 +1,58 @@
-================================
+========================
 Alternative Work Centers
-================================
+========================
 
-Manufacturing several different products simultaneously at the same work center
+Manufacturing several different products simultaneously at the same work center is a common issue
-is a common issue for manufacturing companies. Although in practice, employees can 
+for manufacturing companies. Although in practice, employees can manufacture the goods at another
-manufacture the goods at another work center instead of waiting for one to be available, 
+work center instead of waiting for one to be available, it's not always simple to have visibility
-it's not always simple to have visibility on which work center is busy and plan resources 
+on which work center is busy and plan resources accordingly in real-time.
-accordingly in real-time.
 
 With Odoo, you can configure alternative work centers to solve this issue. This automatically
 checks which work center is busy and which equivalent ones are free, and schedules orders and
 maintenance accordingly.
 
-This way, your process becomes more efficient, as work center utilisation is optimised. 
+This way, your process becomes more efficient, as work center utilisation is optimised.
-
 
 Configure your Work Centers
 ===========================
 
 First, go to the :menuselection:`Manufacturing app --> Configuration --> Settings`. Then, enable
-the Work Orders feature and hit save.
+the :guilabel:`Work Orders` feature and hit :guilabel:`Save`.
 
-.. image:: bill_configuration/bom_3.png
+.. image:: alternative_wc/work-orders-setting.png
-    :align: center
+   :align: center
-    :alt: work order settings ticked
+   :alt: Work order settings ticked in Odoo Manufacturing.
 
+Now, go to :menuselection:`Configuration --> Work Centers` and create two new work centers. Add the
+second work center as an alternative to the first one and vice versa.
 
-Now, go to :menuselection:`Configuration --> Work Centers` and create
+.. image:: alternative_wc/alternative-wc-config.png
-two new work centers. Add the second work center as an alternative to
+   :align: center
-the first one and vice versa.
+   :alt: Create a secondary work center as an alternate to the first.
-
-
-.. image:: alternative_wc/wc_alternate1.png
-    :align: center
-
-
-Next, go to :menuselection:`Products --> Bills of Materials`, choose your product, 
-and add these work centers to the operations of your BOM.
-
-
-.. image:: alternative_wc/wc_alternate2.png
-    :align: center
 
+Next, go to :menuselection:`Products --> Bills of Materials`, choose your product, and add these
+work centers to the operations of your :abbr:`BoM (Bill of Materials)`.
 
+.. image:: alternative_wc/wc-bom-operations.png
+   :align: center
+   :alt: Add work centers to Bill of Materials operations.
 
 Create your Work Orders
 =======================
 
 Now that everything is configured, you can create your *Work Orders*.
-Go to :menuselection:`Operations --> Manufacturing Orders`, and hit **Create**. There, add
-your product to your manufacturing order and plan it. You can then retrieve them 
-from the Work Orders list view, under Operations > Work Orders.
 
-Each new *Work Order*, which will be created before the end of the
+Go to :menuselection:`Operations --> Manufacturing Orders`, and hit :guilabel:`Create`. There, add
-first one, will be scheduled at the alternative work center you
+your product to your manufacturing order and plan it. You can then retrieve them from the
-configured, as shown below. 
+:guilabel:`Work Orders` list view, under :menuselection:`Operations > Work Orders`.
 
-.. image:: alternative_wc/wc_alternate3.png
+Each new *Work Order*, which will be created before the end of the first one, will be scheduled at
-    :align: center
+the alternative work center you configured, as shown below.
 
+.. image:: alternative_wc/work-orders-by-wc.png
+   :align: center
+   :alt: Work order creation and scheduling.
 
 .. note::
-         Keep in mind that, if you add time after production to your work center,
+   Keep in mind that, if you add time after production to your work center, you may have work
-         you may have work orders scheduled for your alternative work center even
+   orders scheduled for your alternative work center even if the usual one is free.
-         if the usual one is free. 

content/applications/inventory_and_mrp/manufacturing/management/bill_configuration.rst

@@ -1,95 +1,97 @@
-=========================
+==========================
-Create Bills of Materials
+Create a bill of materials
-=========================
+==========================
 
-A *Bill of Materials* is a document defining the quantity of each
+A *Bill of Materials* (or *BoM* for short) is a document that defines the quantity of each
-component required to make or deliver a finished product. Additionally, it 
+component required to make or deliver a finished product. It can also include various operations
-can also include various operations and individual step guidelines
+and the individual step guidelines needed to complete a production process.
-needed to complete a production process. 
 
-With Odoo's MRP solution, multiple BOMs can also be linked to each product,
+In Odoo Manufacturing, multiple :abbr:`BoMs (Bills of Materials)` can be linked to each product, so
-so that even product variants can have their *own* tailored BOM.
+that even product variants can have their own tailored :abbr:`BoMs (Bills of Materials)`.
 
-This will help you to optimize your manufacturing process and save time 
+Correctly setting up a :abbr:`BoM (Bill of Materials)` helps optimize the manufacturing process and
-as a result. 
+save time.
 
-Setting up a BoM
+Set up a bill of baterials (BoM)
-================
+================================
-The simplest BoM set up is one without operations or instructions. 
-In this case, you will manage your production using Manufacturing Orders
-only.
 
-To create a BoM from the Manufacturing module, go to :menuselection:`Products --> Bills of Materials`. 
+The simplest :abbr:`BoM (Bill of Materials)` setup is one without operations or instructions, only
-If you click **Create**, the first thing you'll have to do is to specify the final product. 
+components. In this case, the production is solely managed using *Manufacturing Orders*.
-For an existing product, simply select it from the list, or create a new one on the spot. Note 
-that if you go through the product form to create your BOM, the product will already be set for you.
 
-For a standard Bill of Material, keep the default *BoM* type, which is *Manufacture this Product*. 
+To create a :abbr:`BoM (Bill of Materials)` from the :guilabel:`Manufacturing` module, go to
-Now specify the various components that make up the production of your final product and their 
+:menuselection:`Products --> Bills of Materials`. Then, click :guilabel:`Create`. Next, specify the
-respective quantities. You can create components as you go, on the BOM, or create products beforehand,
+:guilabel:`Product`.
-by going to the :menuselection:`Top Menu --> Products --> Create`, and add them later on. 
-
-
-.. image:: bill_configuration/bom_1.png
-    :align: center
-
-.. warning::
-   The destination location should **not** be a scrap location. A scrap location is where you put
-   products that you don't need.
-
-Using the same BoM to describe Variants
----------------------------------------
-
-As suggested above, you can use *BOMs* for specific *Product Variants*. 
-Once the various attributes have been configured on the product form, there 
-are two ways to configure the appropriate BoM for the respective product combination. 
-
-Either create one BoM per variant, by specifying the Product Variant
-in the dedicated field below the product name. Or use one BOM, that contains
-all of the components and for each component, indicate which variant it applies to, 
-using the *Apply on Variants* column, as shown below. 
-
-.. image:: bill_configuration/bom_2.png
-    :align: center
-
-
-Adding Operations
-=================
-
-You can also add operations to your *BoM*, if you want workers to follow instructions
-or register time spent. To use this feature, enable the *Work Orders* feature in the 
-*Manufacturing* app settings, as shown below.
-
-.. image:: bill_configuration/bom_3.png
-    :align: center
 
 .. note::
-         Each operation is unique as it is always linked to only one BOM. This being said, 
+   A :abbr:`BoM (Bill of Materials)` can also be created directly from the product form, in which
-         Operations Operations can be re-used when configuring a new BOM, with the *Copy Existing 
+   case the :guilabel:`Product` field is pre-filled.
-         Operations* feature.
 
-.. image:: bill_configuration/bom_4.png
+For a standard :abbr:`BoM (Bill of Materials)`, set the :guilabel:`BoM Type` to
-    :align: center
+:guilabel:`Manufacture this Product`. Then, click :guilabel:`Add a Line` to specify the various
+components that make up the production of the final product and their respective quantities. New
+components can be created quickly through the :abbr:`BoM (Bill of Materials)`, or can be created
+beforehand in :menuselection:`Manufacturing --> Products --> Products --> Create`. Finally, click
+:guilabel:`Save` to finish creating the :abbr:`BoM (Bill of Materials)`.
 
-Finally, just like for components, operations can also be variant specific only, as shown below.
+.. image:: bill_configuration/bom-form.png
+   :align: center
+   :alt: Set up a Bill of Materials.
 
-.. image:: bill_configuration/bom_5.png
+Specify a bill of materials (BoM) for a product variant
-    :align: center
+-------------------------------------------------------
 
+:abbr:`BoMs (Bills of Materials)` can also be assigned to specific *Product Variants*, with two
+setup options available to choose from.
 
+.. note::
+   In order to assign :abbr:`BoMs (Bills of Materials)` to product variants, the product's variant
+   attributes must already be configured on the product form.
 
-Adding By-Products
+The first method is to create one :abbr:`BoM (Bill of Materials)` per variant by creating a new
-==================
+:abbr:`BoM (Bill of Materials)` and specifying the :guilabel:`Product Variant`. The second method
+is to create one master :abbr:`BoM (Bill of Materials)` that contains all of the components, and
+specify which variant each component applies to using the :guilabel:`Apply on Variants` column.
 
-A *by-product* is a product that is produced on top of the main product 
+.. image:: bill_configuration/bom-variants.png
-of a *BoM*. As opposed to the primary product, there can be more than one on a BOM. 
+   :align: center
+   :alt: Product Variants in the Bill of Materials.
 
-To add *by-products* to a *BoM*, you will first need to enable the by-product
+Set up operations
-feature from the *Manufacturing* app settings.
+=================
 
-.. image:: bill_configuration/bom_6.png
+Add an :guilabel:`Operation` to a :abbr:`BoM (Bill of Materials)` to specify instructions for
-    :align: center
+production and register time spent on an operation. To use this feature, first enable the
+:guilabel:`Work Orders` feature in :menuselection:`Manufacturing --> Configuration --> Settings -->
+Operations`.
 
-Once the feature is enabled, you can add *by-products* to your
+Then, when creating a new :abbr:`BoM (Bill of Materials)`, click on the :guilabel:`Operations` tab
-*BoMs*. Note that if you have Operations, you'll need to specify 
+and click :guilabel:`Add a line` to add a new operation. In the :guilabel:`Create Operations` box,
-in which operation the by-product is produced. 
+give the operation a name, specify the :guilabel:`Work Center` and duration settings. Like
+components, Odoo gives the option to specify a product variant in the :guilabel:`Apply on Variants`
+field so the operation only applies to that variant. Finally, click :guilabel:`Save & Close`.
+
+.. note::
+   Each operation is unique, as it is always exclusively linked to one :abbr:`BoM (Bill of
+   Materials)`. Operations can be reused when configuring a new :abbr:`BoM (Bill of Materials)`,
+   with the :guilabel:`Copy Existing Operations` feature.
+
+.. image:: bill_configuration/copy-existing-operations.png
+   :align: center
+   :alt: Copy Existing Operations feature.
+
+Add by-products to a bill of materials (BoM)
+============================================
+
+A *By-Product* is a residual product that is created during production in addition to the main
+product of a :abbr:`BoM (Bill of Materials)`. Unlike the primary product, there can be more than
+one by-product on a :abbr:`BoM (Bill of Materials)`.
+
+To add by-products to a :abbr:`BoM (Bill of Materials)`, first enable the :guilabel:`By-Products`
+feature in :menuselection:`Manufacturing --> Configuration --> Settings --> Operations`.
+
+Once the feature is enabled, you can add by-products to a :abbr:`BoM (Bill of Materials)` by
+clicking on the :guilabel:`Operations` tab and clicking :guilabel:`Add a line`. Then, name the
+by-product and indicate the :guilabel:`Quantity` and the :guilabel:`Unit of Measure`. If the
+:abbr:`BoM (Bill of Materials)` has configured operations, specify exactly which operation the
+by-product is produced from in the :guilabel:`Produced in Operation` field. Finally, click
+:guilabel:`Save`.