From 18462b5bc0e4dcd26ac4cf7b2b7e4b2f34d14414 Mon Sep 17 00:00:00 2001 From: Christoph Wurst Date: Fri, 26 May 2023 13:05:56 +0200 Subject: [PATCH 1/3] feat(adminmanual): Create critical changes section for admins Signed-off-by: Christoph Wurst --- admin_manual/maintenance/manual_upgrade.rst | 4 ++++ admin_manual/maintenance/package_upgrade.rst | 8 +++++++ admin_manual/maintenance/upgrade.rst | 4 ++++ admin_manual/release_notes.rst | 22 +++++++++++++++++++- admin_manual/release_schedule.rst | 15 ------------- 5 files changed, 37 insertions(+), 16 deletions(-) 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..2794c197d 100644 --- a/admin_manual/release_notes.rst +++ b/admin_manual/release_notes.rst @@ -2,4 +2,24 @@ Release notes ============= -See `the official changelog `_ for release notes. +.. _critical-changes: + +Critical changes +---------------- + +Here you find all important infos about the new release before you upgrade. + +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. + +Changelog +--------- + +See `the official changelog `_ for a complete list of changes. 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 From ef711692c0575007e9a127ea3e614a084f310d85 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Fri, 26 May 2023 14:50:32 +0200 Subject: [PATCH 2/3] chore(release_notes): Use subpages per release Signed-off-by: Joas Schilling --- admin_manual/contents.rst | 2 +- admin_manual/release_notes.rst | 22 +------------------- admin_manual/release_notes/index.rst | 14 +++++++++++++ admin_manual/release_notes/upgrade_to_27.rst | 18 ++++++++++++++++ 4 files changed, 34 insertions(+), 22 deletions(-) create mode 100644 admin_manual/release_notes/index.rst create mode 100644 admin_manual/release_notes/upgrade_to_27.rst 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/release_notes.rst b/admin_manual/release_notes.rst index 2794c197d..affd3b022 100644 --- a/admin_manual/release_notes.rst +++ b/admin_manual/release_notes.rst @@ -2,24 +2,4 @@ Release notes ============= -.. _critical-changes: - -Critical changes ----------------- - -Here you find all important infos about the new release before you upgrade. - -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. - -Changelog ---------- - -See `the official changelog `_ for a complete list of changes. +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..22f833d8c --- /dev/null +++ b/admin_manual/release_notes/index.rst @@ -0,0 +1,14 @@ +============= +Release notes +============= + +.. _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 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..9b63a7ccb --- /dev/null +++ b/admin_manual/release_notes/upgrade_to_27.rst @@ -0,0 +1,18 @@ +======================= +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. + +Changelog +--------- + +See `the official changelog `_ for a complete list of changes. From 7f7c2b61e19446aee8f2be0f9331e41e1d0dbed7 Mon Sep 17 00:00:00 2001 From: Christoph Wurst Date: Fri, 26 May 2023 19:25:46 +0200 Subject: [PATCH 3/3] chore: Move changelog up, fix 27 upgrade headings Signed-off-by: Christoph Wurst --- admin_manual/release_notes/index.rst | 8 ++++++++ admin_manual/release_notes/upgrade_to_27.rst | 11 +++-------- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/admin_manual/release_notes/index.rst b/admin_manual/release_notes/index.rst index 22f833d8c..7c226fae8 100644 --- a/admin_manual/release_notes/index.rst +++ b/admin_manual/release_notes/index.rst @@ -4,6 +4,9 @@ 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. @@ -12,3 +15,8 @@ These sub pages will cover the most important changes in Nextcloud, as well as s :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 index 9b63a7ccb..f609510f8 100644 --- a/admin_manual/release_notes/upgrade_to_27.rst +++ b/admin_manual/release_notes/upgrade_to_27.rst @@ -3,16 +3,11 @@ 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. - -Changelog ---------- - -See `the official changelog `_ for a complete list of changes. +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