upgrading: Split upgrading document to sections

Author: cmouse

docs/installation/upgrade/2.3-to-2.4.md

@@ -21,6 +21,44 @@ setup.
 
 ## Dovecot CE
 
+### Configuration Changes
+
+::: warning
+Dovecot 2.3.x settings will NOT work unless the configuration is changed
+as described in this section.
+:::
+
+<!-- @include: include/2.4-directory-hashing.inc -->
+
+<!-- @include: include/2.4-unknown-invalid-variables.inc -->
+
+<!-- @include: include/2.4-section-naming.inc -->
+
+<!-- @include: include/2.4-empty-userdb-variables.inc -->
+
+#### Required Settings
+
+The first setting in `dovecot.conf` **MUST** now be
+[[setting,dovecot_config_version]]. This helps to avoid unexpected
+configuration changes in the future.
+
+Another new required setting is [[setting,dovecot_storage_version]]. This helps
+to avoid unexpected storage file format incompatibilities.
+
+### Added Features
+
+<!-- @include: include/2.4-added-auth-policy-parameters.inc -->
+
+<!-- @include: include/2.4-added-cassandra-parameters.inc -->
+
+<!-- @include: include/2.4-added-cryptographic-features.inc -->
+
+<!-- @include: include/2.4-added-imapc_features-parameters.inc -->
+
+#### Settings
+
+<!-- @include: include/2.4-added-settings.inc -->
+
 ### Deprecated Features
 
 | Feature | Notes |
@@ -36,6 +74,29 @@ setup.
 | dsync | Use `doveadm sync` instead. `dsync` has been a symlink to `doveadm` already, this release removed the symlink completely. |
 | director | Support for the Dovecot Director architecture has been removed. For a small-scale, unsupported replacement, see [[link,lua_director]]. |
 | replicator | Use [[link,nfs]] or some other shared filesystem instead. |
+<!-- @include: include/2.4-removed-other-features.inc -->
+
+<!-- @include: include/2.4-removed-plugins.inc -->
+
+<!-- @include: include/2.4-removed-settings.inc -->
+
+### Changed Features
+
+<!-- @include: include/2.4-changed-settings.inc -->
+
+#### Default Settings
+
+| Setting | Old Default | New Default | Notes |
+| ------- | ----------- | ----------- | ----- |
+<!-- @include: include/2.4-default-settings.inc -->
+
+<!-- @include: include/2.4-fs-crypt.inc -->
+
+<!-- @include: include/2.4-fts-header-settings.inc -->
+
+### Service defaults
+
+<!-- @include: include/2.4-service-defaults.inc -->
 
 ### Event Changes
 
@@ -50,5 +111,16 @@ setup.
 | [[event,fts_flatcurve_query]] | This event was added. |
 | [[event,fts_flatcurve_rescan]] | This event was added. |
 | [[event,fts_flatcurve_rotate]] | This event was added. |
+<!-- @include: include/2.4-core-events.inc -->
+
+<!-- @include: include/2.4-event-filters.inc -->
+
+<!-- @include: include/2.4-exports.inc -->
+
+<!-- @include: include/2.4-acls.inc -->
+
+### Doveadm
+
+<!-- @include: include/2.4-doveadm.inc -->
 
-<!-- @include: include/2.3-to-2.4.inc -->
+<!-- @include: include/2.4-other.inc -->