Updated CHANGELOG, added skylark scientific documentation

CHANGELOG.md

@@ -6,10 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.6.0] - in planning
+
+*Plan: integrate multiple crop growth models, set up first experiments*
+
+## [0.5.3] - in planning
+
+*Plan: basic farm model (#16), decouple CairoMakie (#81)*
+
+
 ## [0.5.2] - unreleased
 
 ### Added
 
+- Skylark model is largely rewritten to follow a new phase structure (#9)
+
+- animals can occupy territories (see `@occupy`, `@isoccupied`, `@vacate` macros/functions) (#94)
+
+- `@cropcover` macro and function
+
+- scientific documentation for Skylark (will become ODD)
+
 ### Changed
 
 - input files that are now copied to a separate `inputs` directory within the output directory
@@ -22,6 +39,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- old skylark model (has been rewritten, see above)
+
 ### Fixed
 
 - all skylarks now migrate (#90)
@@ -140,6 +159,8 @@ way the species definition macros work and are used.
 
 <comments>
 
+### *PLANNED*
+
 ### Added
 
 ### Changed

docs/builddocs.jl

@@ -41,4 +41,6 @@ makedocs(sitename="Persefone.jl",
                       "species.md"],
                   "crops.md",
                   "farm.md"
+                  "Scientific documentation" => [
+                      "skylark.md"],
                   ])

docs/src/skylark.md

+# Skylark
+
+*Alauda arvensis* is a common and charismatic species of agricultural landscapes.
+At the moment, this implementation is still in development.
+
+**ODD?**
+
+## Life cycle
+
+*TODO*
+
+## Patterns
+
+Patterns that can be used for validation with POM:
+
+- territory size
+
+- *TODO*
+
+## Sources
+
+- Bauer, H.-G., Bezzel, E., & Fiedler, W. (Eds.). (2012). Das Kompendium
+  der Vögel Mitteleuropas: Ein umfassendes Handbuch zu Biologie, Gefährdung
+  und Schutz (Einbändige Sonderausg. der 2., vollständig überarb. und erw.
+  Aufl. 2005). AULA-Verlag
+
+- Delius, J. D. (1965). A Population Study of Skylarks Alauda Arvensis.
+  Ibis, 107(4), 466–492. https://doi.org/10.1111/j.1474-919X.1965.tb07332.x
+
+- Donald et al. (2002). Survival rates, causes of failure and productivity
+  of Skylark Alauda arvensis nests on lowland farmland. Ibis, 144(4), 652–664.
+  https://doi.org/10.1046/j.1474-919X.2002.00101.x
+
+- Glutz von Blotzheim, Urs N. (Ed.). (1985). Handbuch der Vögel Mitteleuropas.
+  Bd. 10. Passeriformes (Teil 1) 1. Alaudidae - Hirundidae. AULA-Verlag, Wiesbaden.
+  ISBN 3-89104-019-9
+
+- Jenny, M. (1990). Territorialität und Brutbiologie der Feldlerche Alauda
+  arvensis in einer intensiv genutzten Agrarlandschaft. Journal für Ornithologie,
+  131(3), 241–265. https://doi.org/10.1007/BF01640998
+
+- Püttmanns et al. (2022). Habitat use and foraging parameters of breeding Skylarks
+  indicate no seasonal decrease in food availability in heterogeneous farmland.
+  Ecology and Evolution, 12(1), e8461. https://doi.org/10.1002/ece3.8461