Skip to content

feat(devmanual): clean up the new release notes #14574

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ChristophWurst merged 1 commit into from
Apr 24, 2026
Merged

feat(devmanual): clean up the new release notes #14574

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,15 @@ App upgrade guide

Once you've created and published the first version of your app, you will want to keep it up to date with the latest Nextcloud features.

.. note::

For the latest release notes, see the :doc:`Release Notes </release_notes/index>`.

These sub pages will cover the most important changes in Nextcloud, as well as some guides on how to upgrade existing apps.

.. toctree::
:maxdepth: 1

upgrade_to_34.rst
upgrade_to_33.rst
upgrade_to_32.rst
upgrade_to_31.rst
Expand Down
2 changes: 2 additions & 0 deletions developer_manual/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -177,4 +177,6 @@
"digging_deeper/changelog": "../app_publishing_maintenance/app_upgrade_guide/index.html",
# Removed 2025-04
"basics/front-end/l10n": "../translations.html",
# Moved 2026-04 - Upgrade to 34 moved to release notes
"app_publishing_maintenance/app_upgrade_guide/upgrade_to_34": "../../release_notes/critical_changes.html",
Copy link
Copy Markdown
Member

@nickvergessen nickvergessen Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should not forget to remove this after branch off? :P

Copy link
Copy Markdown
Member Author

@ChristophWurst ChristophWurst Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It wouldn't do any harm, right? But yes can be removed at some point

Copy link
Copy Markdown
Member Author

@ChristophWurst ChristophWurst Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The single purpose of this redirect is for someone who has already visited https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_34.html to get sent to the new pages instead of a 404.

}
10 changes: 5 additions & 5 deletions ...nance/app_upgrade_guide/upgrade_to_34.rst → ...manual/release_notes/critical_changes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _upgrade_to_34:
.. _critical-changes:

=======================
Upgrade to Nextcloud 34
=======================
================
Critical changes
================

..
Add one section for each change.
Expand All @@ -18,7 +18,7 @@ Update info.xml to add Nextcloud 34 to the support range:
.. code-block:: xml

<dependencies>
<nextcloud min-version="33" max-version="33" />
<nextcloud min-version="34" max-version="34" />
</dependencies>

To allow installation on older versions too, just keep the previous min-version.
Expand Down
17 changes: 15 additions & 2 deletions developer_manual/release_notes/deprecations.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,28 @@
Deprecations
============

In order to improve our platform we are phasing out some APIs. Deprecated APIs are not removed before ???,
unless the breakage can not be avoided.
In order to improve our platform we are phasing out some APIs. Deprecated APIs are kept for at least
three years before removal, unless the breakage can not be avoided.

We highly recommend using the `Nextcloud Rector <https://packagist.org/packages/nextcloud/rector>`_
rules, which can fix some API changes automatically.

New deprecations
----------------

..
Add one section for each group of deprecations (e.g. group files api changes, authentication changes).
Also deprecate the feature at their dedicated documentation page.
After branch-off the contents below will be cleared.

.. todo:: This page needs a section for every new deprecation.

Older deprecations
------------------

You find all current deprecations in this section.

..
This is where we will move the deprecations after the branch off. Enties will stay until actual removal.

Also see the older :ref:`app-upgrade-guide` for deprecations.
11 changes: 8 additions & 3 deletions developer_manual/release_notes/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,18 @@
Release notes
=============

This section is for developers and maintainers who are familiar with an earlier version of the documentation.
Welcome to the release notes. This section is for developers and app maintainers upgrading from earlier versions.

Here we try to summarize what's new. You will find the breaking changes at :ref:`upgrade_to_34`, new deprecations at :ref:`deprecated-apis` and new API features at :ref:`new-apis`.
On this page you will find:

- :ref:`critical-changes` - Critical changes that must be addressed for app compatibility
- :ref:`new-apis` - New developer APIs and features
- :ref:`deprecated-apis` - Deprecated APIs and their removal timeline

.. toctree::
:maxdepth: 3
:hidden:

critical_changes
new
deprecations
../app_publishing_maintenance/app_upgrade_guide/upgrade_to_34
Loading