diff --git a/README.md b/README.md
index c75f42eb..38293b6e 100644
--- a/README.md
+++ b/README.md
@@ -28,15 +28,34 @@ The `pyrealm` package currently includes:
   between carbon capture and water loss. This includes recent extensions to incorporate
   the effects of water stress, slow acclimation processes, models of C3/C4 competition
   and carbon isotope fractionation.
-* The T Model of the allocation of gross primary productivity to estimate net primary
-  productivity and hence plant growth.
 * The SPLASH model for calculating soil moisture and actual evapotranspiration.
+* Initial components of a demography module for modelling plant functional types,
+  cohorts, communities and canopies, including allocation calculations using the T
+  Model.
 * A suite of core physics functions and other utilities used to support the modules
   above.
 
 For more details, see the package website:
 [https://pyrealm.readthedocs.io/](https://pyrealm.readthedocs.io/).
 
+## Version 2.0.0 development
+
+New functionality being implemented after version 1.0.0 has lead to some immediate
+breaking changes in the API, for example in the handling of quantum yield settings in
+the class signatures for the `PModel` and `SubdailyPModel`. As the package uses
+[semantic versioning](https://semver.org/), these changes to the API require that new
+releases be made under a new major version.
+
+We will be publishing a series of "release candidates" of the 2.0.0 package. These will
+be used to identify issues with the current API and try to stabilise a new API. The
+content of version 2.0.0 is not yet finalised, so these release candidates may also add
+new functionality.
+
+We recommend that you update to the most recent release candidate of version 2.0.0. The
+documentation now includes a [migration
+guide](https://pyrealm.readthedocs.io/en/develop/users/versions.html) to help update
+existing code.
+
 ## Using `pyrealm`
 
 The `pyrealm` package requires Python 3 and the currently supported Python versions are:
diff --git a/docs/source/_static/images/pyrealm_logo_master.svg b/docs/source/_static/images/pyrealm_logo_master.svg
index 7aff24ce..925c738d 100644
--- a/docs/source/_static/images/pyrealm_logo_master.svg
+++ b/docs/source/_static/images/pyrealm_logo_master.svg
@@ -7,8 +7,11 @@
    viewBox="0 0 210 297"
    version="1.1"
    id="svg5"
-   sodipodi:docname="pyrealm_logo.svg"
+   sodipodi:docname="pyrealm_logo_master.svg"
    inkscape:version="1.1.2 (b8e25be8, 2022-02-05)"
+   inkscape:export-filename="/Users/dorme/Research/REALM/pyrealm/docs/source/_static/images/pyrealm_logo_white_background.png"
+   inkscape:export-xdpi="300"
+   inkscape:export-ydpi="300"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns:xlink="http://www.w3.org/1999/xlink"
@@ -33,9 +36,25 @@
      inkscape:window-x="47"
      inkscape:window-y="0"
      inkscape:window-maximized="0"
-     inkscape:current-layer="layer2" />
+     inkscape:current-layer="layer4" />
   <defs
      id="defs2" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer4"
+     inkscape:label="Rounded box">
+    <rect
+       style="font-variation-settings:'wght' 500;display:inline;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:0.116221;stroke-opacity:1"
+       id="rect76478"
+       width="150.528"
+       height="53.610382"
+       x="31.801643"
+       y="115.12834"
+       inkscape:export-filename="/Users/dorme/Research/REALM/pyrealm/logo_draft_white_background.png"
+       inkscape:export-xdpi="300"
+       inkscape:export-ydpi="300"
+       ry="12.634459" />
+  </g>
   <g
      inkscape:groupmode="layer"
      id="layer2"
@@ -56,16 +75,6 @@
      inkscape:groupmode="layer"
      id="layer1"
      style="display:inline">
-    <rect
-       style="font-variation-settings:'wght' 500;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:0.116221;stroke-opacity:1"
-       id="rect76478"
-       width="150.52834"
-       height="53.610382"
-       x="31.801643"
-       y="115.12834"
-       inkscape:export-filename="/Users/dorme/Research/REALM/pyrealm/logo_draft_white_background.png"
-       inkscape:export-xdpi="300"
-       inkscape:export-ydpi="300" />
     <text
        xml:space="preserve"
        style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
diff --git a/docs/source/_static/images/pyrealm_logo_white_background.png b/docs/source/_static/images/pyrealm_logo_white_background.png
index dce0043f..96804e30 100644
Binary files a/docs/source/_static/images/pyrealm_logo_white_background.png and b/docs/source/_static/images/pyrealm_logo_white_background.png differ
diff --git a/docs/source/conf.py b/docs/source/conf.py
index ec73fa15..275e37e8 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -219,7 +219,7 @@ class MyReferenceStyle(AuthorYearReferenceStyle):
     "version_selector": True,
     "prev_next_buttons_location": "top",
     "style_external_links": False,
-    "style_nav_header_background": "white",
+    "style_nav_header_background": "grey",
     # Toc options
     "collapse_navigation": False,
     "sticky_navigation": True,
diff --git a/docs/source/index.md b/docs/source/index.md
index 3434c0e7..67f339c8 100644
--- a/docs/source/index.md
+++ b/docs/source/index.md
@@ -58,6 +58,23 @@ The `demography` module
   and respiration {cite:p}`Li:2014bc`. This module is still in active development but a
   lot of initial functionality is present.
 
+## Version 2.0.0 development
+
+New functionality being implemented after version 1.0.0 has lead to some immediate
+breaking changes in the API, for example in the handling of quantum yield settings in
+the class signatures for the `PModel` and `SubdailyPModel`. As the package uses
+[semantic versioning](https://semver.org/), these changes to the API require that new
+releases be made under a new major version.
+
+We will be publishing a series of "release candidates" of the 2.0.0 package. These will
+be used to identify issues with the current API and try to stabilise a new API. The
+content of version 2.0.0 is not yet finalised, so these release candidates may also add
+new functionality.
+
+We recommend that you update to the most recent release candidate of version 2.0.0. The
+documentation now includes a [migration guide](users/versions.md) to help update
+existing code.
+
 ## Indices and tables
 
 * {ref}`genindex`
diff --git a/pyproject.toml b/pyproject.toml
index 00b73a3c..340abfd3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -28,7 +28,7 @@ packages = [
 ]
 readme = "README.md"
 repository = "https://github.com/ImperialCollegeLondon/pyrealm"
-version = "1.0.0"
+version = "2.0.0-rc.1"
 
 [tool.poetry.dependencies]
 dacite = "^1.6.0"