Added PDF documentation for stock management in French

docs/en/stock-management/average-monthly-consumption.md

@@ -0,0 +1,31 @@
+» [Home](../index.md) / [Stock Management](./index.md) / Average Monthly Consumption
+
+# Average Monthly Consumption by Depot
+The Average Monthly Consumption (AMC) is calculated for the enterprise as a
+whole and for individual depots.  The calculation is slightly different
+though, depending on the type of depot.
+
+For dispensing pharmacies, the Average Monthly Consumption is calculated based
+on the distributions/exits to _patients_ or _services_.  These are considered
+consumption of the depot and factor into the average monthly consumption.
+
+For warehouses, BHIMA considers transfers to other depots as consumption in
+addition to the exits to patients and services.  By including transfers, BHIMA
+can estimate when to refill stock in warehouses when they otherwise would not
+be considered.
+
+BHIMA offers two choices of algorithm that differ slighty:
+
+  1. **Default Algorithm** - The average monthly consumption is obtained by
+  dividing the quantity consumed during the period by the number of days with
+  stock during the period, and by multiplying the result by 30.5.
+
+  2. **MSH Algorithm** - The average consumption is obtained by dividing the
+  quantity consumed during the period by number of months of stock (found by
+  subtracting the number of days of stock outs divided by 30.5 from the number
+  of months in the period).  The MSH algorithm is recommended by the
+  [Management Sciences for Health](https://www.msh.org) organization.
+
+These algorithms produce identical or similar results.  The main difference is
+in rounding - the MSH algorithm converts to months before the computation
+while the default algorithm converts to months as a last step.

docs/en/stock-management/depot.md

@@ -12,8 +12,11 @@
   </p>
 </div>
 
-
-Depots are used to store stock articles.  We cannot discuss stock without talking about depots since all stock articles are assigned to specific depots. The depot forms a container for the enterprise's stock, and allows users to enter stock through [Stock Entry](./movement.entry.md), or dispense stock through [Stock Exit](./movement.exit.md).
+Depots are used to store stock articles.  We cannot discuss stock without
+talking about depots since all stock articles are assigned to specific
+depots. The depot forms a container for the enterprise's stock, and allows
+users to enter stock through [Stock Entry](./movement.entry.md), or dispense
+stock through [Stock Exit](./movement.exit.md).
 
 To see the registry of depots:
 
@@ -24,27 +27,38 @@ To see the registry of depots:
   </p>
 </div>
 
-To edit an existing depot, click on the **Action** link on the right end of the row of the depot to edit.  Then click on the "Edit" link, make the changes on to the depot and then click the **[Submit]** button on the bottom of the edit form.
+To edit an existing depot, click on the **Action** link on the right end of
+the row of the depot to edit.  Then click on the "Edit" link, make the changes
+on to the depot and then click the **[Submit]** button on the bottom of the
+edit form.
 
-To create a new depot, click on the **[Add Depot]** button in the top right corner of the page.  This opens a
-modal window to enter the depot information.
+To create a new depot, click on the **[Add Depot]** button in the top right
+corner of the page.  This opens a modal window to enter the depot information.
+While creating a new depot, you will need to specify the supplier.  For more
+details on creating and editing suppliers within BHIMA, please see the
+[Supplier documentation](./supplier.md).
 
 
 ## Depot Heirarchies
-BHIMA allows sites to structure their depots in a tree hierachary of parents and children, similar to the chart
-of accounts.  This feature exists to allow easier permissions management.  If a user is responsible for many depots
-in a region, it may make sense to group these regionally and assign a user the permissions to all child depots in that
-region.  Functionally, the parent-child relationship has no bearing on which depots can transfer stock between one another.
+BHIMA allows sites to structure their depots in a tree hierachary of parents
+and children, similar to the chart of accounts.  This feature exists to allow
+easier permissions management.  If a user is responsible for many depots in a
+region, it may make sense to group these regionally and assign a user the
+permissions to all child depots in that region.  Functionally, the
+parent-child relationship has no bearing on which depots can transfer stock
+between one another.
 
 
 ## Depot Capabilities
-Each depot can be customized to allow only certain kinds of entries and exits.  For example, a central
-warehouse might not distribute directly to patients, but may serve as a staging center to distribute to
-other depots.  Similarly, a depot could be a distribution center only and not allow direct entry of
+Each depot can be customized to allow only certain kinds of entries and exits.
+For example, a central warehouse might not distribute directly to patients,
+but may serve as a staging center to distribute to other depots.  Similarly, a
+depot could be a distribution center only and not allow direct entry of
 donated or purchased stock.
 
 ## Getting Access to a Depot
-Before managing or accessing a depot, a user have authorization. To get access, open the User Management page:
+Before managing or accessing a depot, a user have authorization. To get
+access, open the User Management page:
 
 <div class="bs-callout bs-callout-success">
   <p>
@@ -53,43 +67,22 @@ Before managing or accessing a depot, a user have authorization. To get access,
   </p>
 </div>
 
-Use the **Action** link on the right end of the line for the user you wish to update and click on the "Depot Management" link.  A form will appear that will allow you to enter the name of the depot for which you want to obtain permission to manage.  Click in the box under the "Add:" and type.  After you type in a few characters, the full name should appear.  Click on it to select it.  The depot name should now be shown.  Then confirm the authorization by clicking on the blue **[Submit]** button.  If the operation is successful, a green "Updated" message should appear briefly at the top of the page.
-
-Enabling this authorization is only necessary once (per user). Once done, the user should be able to carry out operations related to stock movements with the authorized depot.
-
-
-## Average Monthly Consumption by Depot
-The Average Monthly Consumption (AMC) is calculated for the enterprise as a whole and for individual depots.  The
-calculation is slightly different though, depending on the type of depot.
-
-For dispensing pharmacies, the Average Monthly Consumption is calculated based on the distributions/exits to _patients_
-or _services_.  These are considered consumption of the depot and factor into the average monthly consumption.
-
-For warehouses, BHIMA considers transfers to other depots as consumption in addition to the exits to patients and services.
-By including transfers, BHIMA can estimate when to refill stock in warehouses when they otherwise would not be considered.
-
-BHIMA offers two choices of algorithm that differ slighty:
-
-  1. **Default Algorithm** - The average monthly consumption is obtained by dividing the quantity consumed during the period by
-  the number of days with stock during the period, and by multiplying the result by 30.5.
-  2. **MSH Algorithm** - The average consumption is obtained by dividing the quantity consumed during the period by number of
-  months of stock (found by subtracting the number of days of stock outs divided by 30.5 from the number of months in the period).
-  The MSH algorithm is recommended by the [Management Sciences for Health](https://www.msh.org) organization.
-
-These algorithms produce identical or similar results.  The main difference is in rounding - the MSH algorithm converts to months
-before the computation while the default algorithm converts to months as a last step.
-
-# Suppliers
-
-Since the stock in a **Depot** orginally comes from a supplier, the available **Supplier**s must be configured before creating purchase orders for stock from suppliers.  To create a supplier:
-
-<div class="bs-callout bs-callout-success">
-  <p>
-  <i>menu</i> > Administration > <strong>Supplier Management</strong> <br>
-   &rArr; Opens a registry of known Suppliers and allows editing existing Suppliers and creating new ones
-  </p>
-</div>
-
-To edit an existing supplier, click on the **Actions** link on the far right of the line with the supplier you wish to edit and click on the "Edit" link.
-
-To create a new Supplier, click on the **[Add A Supplier]** button on the top right.  Most of the form entries are self-explanatory.  The "Group" field offers you a list of pre-configured creditor groups to choose from; click on the one that is related to the supplier in creation for the to select.   Finally, click on the blue "Submit" button at the bottom right of the form to confirm the configuration and create the supplier.   A message will be shown to indicate success or to explain errors in the form needing correction. 
+Use the **Action** link on the right end of the line for the user you wish to
+update and click on the "Depot Management" menu item.  A form will appear that
+will allow you to enter the name of the depot you want to obtain permission to
+manage. Click in the input box under the "Add:" and begin typing the depot
+name. After you type in a few characters, BHIMA will look up the depot by name
+and the full name should appear. Click on it to select it. The depot name
+should now be shown.
+
+If you do not see any depots names loaded, this could mean that either you
+have a slow connection to the server or your have mistyped your depot
+name. Confirm the name is of an existing depot and try again.
+
+Then confirm the authorization by clicking on the blue **[Submit]** button.
+If the operation is successful, a green "Updated" message will appear briefly
+at the top of the page.
+
+Enabling this authorization is only necessary once (per user). Once done, the
+user will be able to carry out operations related to stock movements with the
+authorized depot.

docs/en/stock-management/glossary.md

@@ -9,9 +9,9 @@
     related stock items) as needed by Patients, Services, or other Pharmacies.
 
      - Stock Pharmacy - A Stock Pharmacy is typically a local storage facility
-       that receives stock from depots and supplies stock to other pharmacies.
-       A stock pharmacy does not generally dispense medications directly to
-       patients.
+       that receives stock from depots and suppliers and provides stock to
+       other pharmacies.  A stock pharmacy does not generally dispense
+       medications directly to patients.
 
      - Dispensing Pharmacy - A Dispensing Pharmacy (Pharmacie D'Usage in
        French) is a pharmacy that dispenses stock to patients, wards, and
@@ -27,15 +27,16 @@
 
   - **SERVICE** - In the BHIMA perspective, a "Service" is a department in the
     hospital such as "pediatrics", "ophthalmology", "internal medicine",
-    "pharmacy", and "administration".  Services can be assigned invoices,
+    "pharmacy", or "administration".  Services can be assigned invoices,
     consume medications, contain staff, and have both profit and loss centers.
 
   - **STOCK** - "Stock" are any items used in the operation of a hospital or
     clinic.  Examples include drugs for treating patients, medical equipment
     and supplies, and administrative supplies.  "Stock" items are often
-    purchased in "Lots" which include a number of the stock items.  Note that
-    "Lot Numbers" are sometimes given by manufacturers and are not necessarily
-    unique to BHIMA.
+    purchased in "Lots" which include a number (or identifier) of the stock
+    items.  Where possible BHIMA uses the lot number provided by the
+    manufacturer (see this [Wikipedia article](https://en.wikipedia.org/wiki/Lot_number) 
+    for more information).
 
   - **STOCK ADJUSTMENT** - When a physical inventory of stock reveals that the
     actual count of stock items differs from the count in the "Theoretical

docs/en/stock-management/index.md

@@ -11,30 +11,33 @@ hospitals.  Below you'll find an index to particular subsections that may be of
 
 3. [Depots](./depot.md)
 
-4. [Stock Settings](./stock.settings.md)
+4. [Suppliers](./supplier.md)
 
-5. [Stock Accounting](./accounting/index.md)
+5. [Stock Settings](./stock.settings.md)
+
+6. [Stock Accounting](./accounting/index.md)
     1. [OHADA Accounting](./accounting/ohada.md)
     2. [IFRS Accounting](./accounting/ifrs.md)
 
-6. [Stocks Movements](./movement.md)
+7. [Stocks Movements](./movement.md)
     1. [Stocks Entries](./movement.entry.md)
     2. [Stocks Exits](./movement.exit.md)
     3. [Adjustments](./movement.adjustment.md)
+    4. [Average Monthly Consumption](./average-monthly-consumption.md)
 
-7. [Inventory Reports]()
+8. [Inventory Reports]()
     1. [Stocks]()
     2. [Inventory Status]()
     3. [Inventory Value]()
 
-8. [Inventory Records]()
+9. [Inventory Records]()
     1. [Lots Registry]()
     2. [Articles in Stock Registry]()
     3. [Movement Log]()
 
-9. [Additional Tools]()
+10. [Additional Tools]()
     1. [Import Stock from a CSV File]()
     2. [Assignment of Lots]()
     2. [Lot Assignment History]()
 
-10. [Glossary of Stock-Related Terms](./glossary.md)
+11. [Glossary of Stock-Related Terms](./glossary.md)

docs/en/stock-management/movement.adjustment.md

@@ -23,7 +23,7 @@ To perform stock adjustments, go to the Stock Adjustment page:
 <img src="./images/stock-adjustment-form.png" alt="Stock Adjustment Form" width="800">
 
 - Do not forget that for any operation that affects a depot you must first
-  make sure that you are in the depot concerned; if not, change the depot
+  make sure that you are operating on the depot concerned; if not, change the depot
   using the **[Menu]** on the top right and choose the "Change Depot" item.  A
   dialog allowing you to choose the appropriate depot will appear.  Choose the
   desired depot and click on the **[Submit]** button.  You will see the main
@@ -49,8 +49,8 @@ To perform stock adjustments, go to the Stock Adjustment page:
   <img src="./images/stock-adjustment-unpopulated-form.png" alt="Stock Adjustment Form Unpopulated" width="800">
 
 - In the "Code" column, enter the a few characters in the name of the stock
-  item.  A list of items with the same characters appears.  Click on the
-  desired item to select it.
+  item.  A list of items with inventory codes including those characters
+  appears.  Click on the desired item to select it.
 
 - Click on the relevant box in the "lot" column.  The system will show the
   different existing lots.  Select the relevant one by clicking on it.

docs/en/stock-management/movement.entry.md

@@ -1,4 +1,4 @@
-» [Home](../index.md) / [Inventory Management](./index.md) / [Stock Movements](./movement.md) / Stock Entry
+» [Home](../index.md) / [Stock Management](./index.md) / [Stock Movements](./movement.md) / Stock Entry
 
 # Stock Entry
 
@@ -8,6 +8,14 @@ There are four ways that stock enters a depot that will be described in detail b
 - [From a donation](#stock-entry-by-donation)
 - [From a transfer from another depot](#stock-entry-by-transfer)
 
+Before a depot or pharmacy gets stock to "enter", it is necessary to determine
+how much stock is needed.  Depots typically need that information to put
+together a purchase order.  Pharmacies typically need this information to
+request stock from a depot.  In any case, computations of how much stock is
+being used (per month) is helpful.  This is provided by the "Average Monthly
+Consumption".  For more detaisl about that, please see the section on [Average
+Monthly stock Consumption](./average-monthly-consumption.md).
+
 
 ## Stock Entry by Purchase
 The process of purchasing stock for a depot includes several steps.
@@ -65,7 +73,7 @@ This will bring up a form like this:
  - To confirm and save the order, click on the "Save" button at the bottom of
    the form on the right.
 
- - To abort creating the purchase order, click on the blue "Clear" button on
+ - To abort creating the purchase order, click on the **[Clear]** button on
    the bottom right of the form.
 
 ### Confirm a purchase order
@@ -93,7 +101,6 @@ for the purchase order and click on the "Edit Status" link and change the status
 
 WARNING: Once a purchase order is confirmed, it can no longer be edited.
 
-
 ### Receive and enter stock from a purchase order
 
 When a delivery stock for a purchase order arrives and the requesting depot,
@@ -122,7 +129,7 @@ First, we need to open the stock "Entry" form:
   <img src="./images/entry-select-purchase-order.png" alt="Select Purchase Order" width="600">
 
   - You can verify the purchase order details by clicking on its "Reference"
-    number (in blue).  This will bring up a Purchase Oder receipt with
+    number (in blue).  This will bring up a Purchase Order receipt with
     details.  Click on the "Close" button on the bottom right when you are
     finished reviewing the details.
 
@@ -132,7 +139,7 @@ First, we need to open the stock "Entry" form:
     be highlighted.
 
   - Press the blue **[Submit]** button at the bottom right of the form to
-    confirm
+    confirm.
 
   - This will bring up the entry form pre-populated with the stock items from
     the purchase order.
@@ -148,7 +155,7 @@ First, we need to open the stock "Entry" form:
   - However, notice that the red X-mark to the left of the stock item line shows
     you that something still needs to be done.  In order to finish, we must
     specify the "Lots" entry for the item.  For further information about
-    Lots, see the glossary.
+    Lots, see the [glossary](./glossary.md).
 
   - Click on the blue "Lots" link (by its icon).  The Lot entry form will be
     displayed:
@@ -263,7 +270,7 @@ Bring up the Stock Entry form:
   </p>
 </div>
 
-- **FIRST**n, make sure the receiving Depot is selected (look on the
+- **FIRST**, make sure the receiving Depot is selected (look on the
   "bread-crumb" line at the top of the form).  If the receiving depot is
   incorrect, select the correct one using the "Choose Depot" link under the
   **[Menu]** button on the top right of the form.
@@ -284,7 +291,8 @@ You should see the entry form like this:
 <img src="./images/entry-transfer-form.png" alt="Stock Entry by Transfer Form" width="800">
 
 - Note that you might not see all four sources (Purchase, Integration,
-  Donation, Transfer) depending on how the Depot was configured.
+  Donation, Transfer) depending on how the Depot was configured.  See 
+  [Depot Management](/.depot.md) for more information.
 
 - At this point, you may click on the blue "Lot" link on each entry line to
   update or correct the Lot identifier, quantity, and expiration date based