diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index e0789991a..9a580bafc 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -6,7 +6,7 @@ Table of contents :maxdepth: 2 index - release_notes + release_notes/index release_schedule installation/index configuration_server/index diff --git a/admin_manual/maintenance/manual_upgrade.rst b/admin_manual/maintenance/manual_upgrade.rst index 985db124f..0cb8ca800 100644 --- a/admin_manual/maintenance/manual_upgrade.rst +++ b/admin_manual/maintenance/manual_upgrade.rst @@ -2,6 +2,10 @@ Upgrade manually ================ +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + Always start by making a fresh backup and disabling all 3rd party apps. 1. Back up your existing Nextcloud Server database, data directory, and diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index ea4a5afef..772326512 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -58,6 +58,10 @@ using Snappy Base 16.04 as it's currently unreleased. Upgrade tips ------------ +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + Upgrading Nextcloud from a Snap is just like upgrading any snap package. For example: @@ -86,6 +90,10 @@ This example is for CentOS/RHEL/Fedora:: Upgrading across skipped releases --------------------------------- +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + It is best to update your Nextcloud installation with every new point release, and to never skip any major releases. While this requirement is being worked on, for the moment If you have skipped any major releases you can bring your diff --git a/admin_manual/maintenance/upgrade.rst b/admin_manual/maintenance/upgrade.rst index 534779cb5..263183abe 100644 --- a/admin_manual/maintenance/upgrade.rst +++ b/admin_manual/maintenance/upgrade.rst @@ -58,6 +58,10 @@ based updater but on the command line. Prerequisites ------------- +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + You should always maintain :doc:`regular backups ` and make a fresh backup before every upgrade. diff --git a/admin_manual/release_notes.rst b/admin_manual/release_notes.rst index e2efc6428..affd3b022 100644 --- a/admin_manual/release_notes.rst +++ b/admin_manual/release_notes.rst @@ -2,4 +2,4 @@ Release notes ============= -See `the official changelog `_ for release notes. +The release notes have been split into :ref:`subpages per Nextcloud release`. diff --git a/admin_manual/release_notes/index.rst b/admin_manual/release_notes/index.rst new file mode 100644 index 000000000..7c226fae8 --- /dev/null +++ b/admin_manual/release_notes/index.rst @@ -0,0 +1,22 @@ +============= +Release notes +============= + +.. _critical-changes: + +Critical changes +---------------- + +Once you've installed and configured your server, you will want to keep it up to date with the latest Nextcloud features. + +These sub pages will cover the most important changes in Nextcloud, as well as some guides on how to upgrade existing installations. + +.. toctree:: + :maxdepth: 1 + + upgrade_to_27.rst + +Changelog +--------- + +See `the official changelog `_ for a complete list of changes. diff --git a/admin_manual/release_notes/upgrade_to_27.rst b/admin_manual/release_notes/upgrade_to_27.rst new file mode 100644 index 000000000..f609510f8 --- /dev/null +++ b/admin_manual/release_notes/upgrade_to_27.rst @@ -0,0 +1,13 @@ +======================= +Upgrade to Nextcloud 27 +======================= + +System requirements +------------------- + +* PHP8.2 is recommended over PHP8.1. + +Exposed system address book +--------------------------- + +Nextcloud 27 exposes the :ref:`system address book`. Restrict the enumeration settings if your users should not see other users. \ No newline at end of file diff --git a/admin_manual/release_schedule.rst b/admin_manual/release_schedule.rst index e8f51b029..6fb44697e 100644 --- a/admin_manual/release_schedule.rst +++ b/admin_manual/release_schedule.rst @@ -15,18 +15,3 @@ Maintenance releases -------------------- Maintenance releases are scheduled in a 4 week cycle with one week before the release date having the freeze and RC 1. - -Critical changes ----------------- - -* PHP 8.0 is now deprecated. Please upgrade to PHP 8.1 or higher. -* PHP 8.2 is now supported. -* The recommended webserver configuration has changed to no longer include a default redirect to the login page - * For Apache this change will automatically come with the ``.htaccess`` file provided by the release - * for nginx administrators should ensure that their config is up to date with the `documentation `_ - * The relevant lines to remove are ``error_page 403 /core/templates/403.php;`` and ``error_page 404 /core/templates/404.php;`` - -You can find important documentation for app developers here: https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.html -Each document lists a link to the breaking changes of the corresponding release. - -.. TODO ON RELEASE: Update version number above on release