diff --git a/docs/src/crops.md b/docs/src/crops.md
index 54fb1755397d2678c0593d4b67c29927eb4589e5..7d9b792c48a7255398bf2d48eaa858dfc11db8b2 100644
--- a/docs/src/crops.md
+++ b/docs/src/crops.md
@@ -1,7 +1,18 @@
 # Crop submodel
 
-Eventually, Persefone will include a full-blown crop-growth model (an adaptation of
-AquaCrop, created by the FAO). At the moment, we are only working with a very basic mock-up.
+Eventually, the plan is to have Persefone include a reimplementation of the AquaCrop model, 
+a well-established crop growth model developed by the FAO. Until then, we are using the
+crop growth submodel used in [ALMaSS](https://doi.org/10.1016/S0304-3800(03)00173-X).
+
+## farmplot.jl
+
+This file is responsible for the farm plots, i.e. the indidivual fields that farmers
+manage.
+
+```@autodocs
+Modules = [Persefone]
+Pages = ["crop/farmplot.jl"]
+```
 
 ## crops.jl
 
diff --git a/docs/src/farm.md b/docs/src/farm.md
index c93b8c141eabf936e87d86f0c2e76a4901b54a01..6701edf8323578c07ebd4a1e98ddf50c2a575d17 100644
--- a/docs/src/farm.md
+++ b/docs/src/farm.md
@@ -1,7 +1,8 @@
 # Farm submodel
 
-Eventually, Persefone will include multiple farm-decision submodels. At the moment, 
-we are only working with a very basic mock-up.
+Eventually, the aim is to create a full socio-economic farm decision model for Persefone.
+However, for the time being, we will restrict ourselves to a simple model that executes
+typical farm operations and crop rotations.
 
 ## farm.jl
 
diff --git a/docs/src/index.md b/docs/src/index.md
index f613750bc1998f370fe56c1abba2f683388f3b58..0e3af50abd3cdc36bb9110ff5cde8162ac341c20 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -4,12 +4,15 @@ CurrentModule = Persefone
 
 # Introduction
 
-Persefone is an agent-based, socio-economic-ecological model of agricultural landscapes
-in Europe under the Common Agricultural Policy (CAP).
+**View the source code on [Gitlab](https://git.idiv.de/xo30xoqa/persefone).**
 
-It's aim is to investigate how policy affects farmer decision-making, and how this in turn
-affects various animal species. It includes a farm submodel, a crop-growth submodel, and
-an ecological submodels.
+Persefone.jl models agricultural practice and how it impacts animal species at a landscape
+scale. It includes a farm submodel, a crop growth submodel, and individual-based models
+of multiple indicator species. Its aim is to investigate how changes in farm operations
+(e.g. through policy changes in the CAP) influence biodiversity.
+
+The model is based on the [Agents.jl](https://juliadynamics.github.io/Agents.jl/stable/) 
+framework. It is currently in the early stages of development.
 
 ## Running the model
 
@@ -82,4 +85,4 @@ cropmodel = "linear" # crop growth model to use, "linear" or "aquacrop" (not yet
 	combination of parameters that you entered (i.e. do a full-factorial simulation
 	experiment).
 
-*Last updated: 2023-07-27 (commit 1e6e7d6)*
+*Last updated: 2023-08-31 (commit 38abd8d)*
diff --git a/docs/src/simulation.md b/docs/src/simulation.md
index 8ab547c37764c3af16a79395d3a10c53aaff9447..1468016e0d1494678b3b97e2adb5e6d3a209b7de 100644
--- a/docs/src/simulation.md
+++ b/docs/src/simulation.md
@@ -1,7 +1,7 @@
 # Simulation
 
-The `core` directory holds source files that are important for all submodels, including
-scheduling, landscape, and input/output functions.
+The `core` and `world` directories hold source files that are important for all submodels, 
+including scheduling, landscape, weather, and input/output functions.
 
 ## simulation.jl
 
@@ -18,5 +18,14 @@ This file manages the landscape maps that underlie the model.
 
 ```@autodocs
 Modules = [Persefone]
-Pages = ["core/landscape.jl"]
+Pages = ["world/landscape.jl"]
+```
+
+## weather.jl
+
+This file reads in weather data and makes it available to the model.
+
+```@autodocs
+Modules = [Persefone]
+Pages = ["world/weather.jl"]
 ```