[Agriculture] documentaion (#11867)

erpnext/docs/user/manual/en/agriculture/analytics/index.md

@@ -0,0 +1,12 @@
+# Analytics
+
+This part of the Agriculture module is used for tracking data and report generation
+
+All the data pertaining to the following doctypes can be tracked by ERPNext
+
+* Plant Analysis
+* Soil Analysis
+* Water Analysis
+* Soil Texture
+* Weather
+* Agriculture Analysis Criteria

erpnext/docs/user/manual/en/agriculture/crops_and_land/crop.md

@@ -0,0 +1,50 @@
+# Crop 
+
+Now we need to specify what our crop will be. A crop summarizes all that is necessary before creatng our first crop cycle or planting.
+
+> Agriculture > Crop
+
+On the desk, click on the Crop icon. A list will show any existing Crops.
+
+On the top right, click on 'New'  to create the first Crop. A new Crop document will open, and we will enter basic information.
+
+The basic information should be entered as such:
+
+* Title: Carrot from carrot-top
+* Crop Name: Carrot
+* Scientific name: Daucus Carota
+* Type: Biennial
+* Planting UOM: Unit
+* Yield UOM: Grams
+
+Click Save 
+
+We will skip the Materials Required, Byproducts and Produce sections. In the Ideal Agriculture Task List we enter some planned tasks such as planting, watering, and harvesting. (Please note, our activity list will be intentionally abbreviated for illustraion purposes. For this example we will prepare our field, plant the next day, water only once, add a cover after germination on day 12, remove weeds at day 19, and harvest at day 90.
+
+The first row will look like this:
+
+* Task Name: Preparation - Make rows
+* Start Day: 1
+* End Day: 1
+* Holiday Management: Ignore holidays
+
+When done, you can click 'Save' to prevent any work from being lost.
+
+We are not done yet, we simply have saved the minimum required information!
+Continue filling the next rows with Task Name, Start Day, End Day and Holiday Management.
+
+
+* Row 2: Preparation - Add mulch cover, 1, 1, Previous Business Day
+* Row 3: Planting - Sow the seeds, 2, 2, Previous Business Day
+* Row 4: Water - 10ml per plant, 2, 2, Ignore holidays
+* Row 5: Disease - Pest control - Cover with Fine Net, 12, 12, Previous Business Day
+* Row 6: Weed Control - Remove weeds, 19, 19, Previous Business Day
+* Row 7: Harvest - When top is at 5cm, 90, 90, Previous Business Day
+
+Click 'Save'
+
+You form should now look something like this
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/crops_and_land/crop.png">
+
+Repeat step 2 for as many crops as you need. You can save some time by duplicating existing crops and modifying only the necessary items

erpnext/docs/user/manual/en/agriculture/crops_and_land/crop_cycle.md

@@ -0,0 +1,30 @@
+# Crop Cycle
+
+Once we have defined our crop, we can create as many crop cycles as we like, using the parameters outlined previously
+
+On the desk, clik on the Crop Cycle icon.  A list will show any existing Crop Cycles.
+
+> Agriculture > Crop Cycle
+
+On the top right, click on New to create the first Crop Cycle. A new Crop Cycle document will open, and right away you see that two of the required items are a Land Unit and a Crop. We shall give it a descriptive name, to differentiate it from Crop Cycles we might create later.
+
+* Title: Carrot Planting 2017
+* Land Unit: Add a row, and select, Carrot Field 1
+* Crop: Carrot from carrot-top
+* Start Date: Today
+* Leave the ISO 8016 Standard (week count) box unchecked
+* Skip the next four fields for Crop Spacing
+
+Save the new Crop Cycle
+
+It should now look something like this
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/crops_and_land/crop_cycle.png">
+
+Repeat these for every Crop Cycle you need
+
+As you can see a Project was created, with the same name as the Crop Cycle and linked to the Crop Cycle. If you click on the project, you'll see all the 'Sample Tasks' from the linked Crop, i.e. 'Carrot from carrot-top' in this case, were converted into actual 'Tasks' and linked to the Project, for easy management
+
+> Projects > Project
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/crops_and_land/projects.png">

erpnext/docs/user/manual/en/agriculture/crops_and_land/index.md

@@ -0,0 +1,15 @@
+# Crops and Land
+
+The core and most important elements of Agriculture module are:
+
+* Land Unit: Representing the physical space where the crops are planted.
+* Crop: Characteristics of the crop, inputs and expected outputs, expected calendar of activities and harvest, etc.
+* Crop Cycle: Individual representation of a single planting in a specific area. (Links a crop to a Land Unit for a specified period)
+
+Here we will learn to do a quick setup with the essential requirements to manage a simple example crop, Carrots.
+
+ These instructions assume you have already completed the basic ERPNext setup, and you have the ERPNext desk on your browser window.
+
+### Topics
+
+{index}

erpnext/docs/user/manual/en/agriculture/crops_and_land/index.txt

@@ -0,0 +1,3 @@
+land_unit
+crop
+crop_cycle

erpnext/docs/user/manual/en/agriculture/crops_and_land/land_unit.md

@@ -0,0 +1,31 @@
+# Land Unit
+
+Before we do anything, we need to define some details about where our crops will be planted. We will first create our farm as a parent land unit, and then we will add one or more fields as children or nodes, belonging to the parent.
+
+> Agriculture > Land Unit
+
+On the desk, click on the Land Unit icon. assets/img/new-land-unit-icon.png A list will show any existing Land Units.
+
+On the top right, click on New  to create the first Land Unit.
+
+* Land Unit Name: Carrot Farm
+* Parent Land Unit: All Land Units
+* Check the box next to 'Is Group'
+* Location: plot the area as you please
+
+Click Save
+
+It should look something like this
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/crops_and_land/land_unit.png">
+
+With the farm created, we can now create our first Carrot Field! Click on New 
+
+* Land Unit Name: Carrot Field 1
+* Parent Land Unit:select the one we just created in step two, i.e. Carrot Farm
+* Leave the 'Is Group' box unchecked
+* Location: plot the area as you please
+
+Click Save
+
+Repeat step 3 for as many fields as you need

erpnext/docs/user/manual/en/agriculture/diseases_and_fertilizer/disease.md

@@ -0,0 +1,24 @@
+# Disease 
+
+This part of Agriculture module deals with the management of Diseases, which may include various types of bacteria, funcgi, viruses, or pests which affect he Crop
+
+On the desk, click on the Disease icon. A list will show any existing Diseases.
+
+> Agriculture > Disease
+
+The basic information should be entered as such:
+
+* Disease Name: Aphids
+* Scientific name: Aphidoidea
+* Description: you could give a description of the disease here
+* Treatment Task: This may contain a list of all the Tasks which need to to be executed in orfer to get rid of the Disease
+
+Once you fill the form, click Save
+
+Click Save
+
+Now it should look something like this
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/diseases_and_fertilizer/disease.png">
+
+These Tasks will be imported into the Crop Cycle Project if you choose to add this Disease to the list of Detected Diesase in Crop Cycle

erpnext/docs/user/manual/en/agriculture/diseases_and_fertilizer/fertilizer.md

@@ -0,0 +1,5 @@
+# Fertilizer
+
+This is used to keep track of available fertilizers, and their chemical composition, which is linked to the Item master
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/diseases_and_fertilizer/fertilizer.png">

erpnext/docs/user/manual/en/agriculture/diseases_and_fertilizer/index.md

@@ -0,0 +1,7 @@
+# Disease and Fertilizer
+
+This part of Agriculture module deals with the management of Diseases which affect the Crop and Fertilizers which may be used to promote the growth of the Crop
+
+### Topics
+
+{index}

erpnext/docs/user/manual/en/agriculture/diseases_and_fertilizer/index.txt

@@ -0,0 +1,2 @@
+disease
+fertilizer

erpnext/docs/user/manual/en/agriculture/index.md

@@ -0,0 +1,22 @@
+# Agriculture
+
+Farmers know that even a small operation requires intensive recordkeeping. A well-run farm requires proper management of accounting, payroll, suppliers, customers and logistics to name a few areas. ERPNext already helps organize these activities.
+
+A farm requires additional attention to manage its productive units (plots of land), time sensitive crop activities (such as planting, irrigating, fertilizing, etc.), recording environmental and crop data for analysis, and reports to help make effective decisions.
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/agri_desk.png">
+
+The Agriculture module in ERPNext helps you keep track of your farming operations. It allows you keep records for each field where you farm, such as geospatial and soil texture characteristics. It allows you to:
+
+* Manage the physical spaces where you plant your crops
+* Manage your crops
+* Record analysis data
+* Plan activities related to your crops
+* Record sale of the harvest or transfer to warehouse for further processing
+* View reports
+
+<img class="screenshot" alt="Task" src="/home/coding_coffee/Work/frappe-bench/apps/erpnext/erpnext/docs/assets/img/agriculture/agri_doctypes.png">
+
+### Topics
+
+{index}

erpnext/docs/user/manual/en/agriculture/index.txt

@@ -0,0 +1,3 @@
+crops_and_land
+diseases_and_fertlizers
+analytics