From 018bcf7b7a632b662dd8ad9602a40ffe5ddec840 Mon Sep 17 00:00:00 2001
From: JSap0914 <JSap0914@users.noreply.github.com>
Date: Mon, 13 Jul 2026 17:14:22 +0900
Subject: [PATCH 1/2] Highlight documentation for derived timeseries

---
 AUTHORS.rst        | 1 +
 RELEASE_NOTES.md   | 7 +++++++
 docs/tutorials.rst | 9 +++++++++
 3 files changed, 17 insertions(+)

diff --git a/AUTHORS.rst b/AUTHORS.rst
index 229538c4f..442734b1d 100644
--- a/AUTHORS.rst
+++ b/AUTHORS.rst
@@ -25,6 +25,7 @@ The following persons contributed to the development of the |pyam| package:
 - Fridolin Glatter `@glatterf42 <https://github.com/glatterf42>`_
 - Linh Ho `@linhho <https://github.com/LinhHo>`
 - Max Wolschlager `@meksor <https://github.com/meksor>`
+- `@JSap0914 <https://github.com/JSap0914>`_
 
 | The core maintenance of the |pyam| package is done by
   the *Scenario Services & Scientific Software* research theme
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index fc8aba068..9b8c0063b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -1,3 +1,10 @@
+# Next Release
+
+## Individual updates
+
+- [#984](https://github.com/IAMconsortium/pyam/issues/984) Highlight documentation
+  for computing derived timeseries data
+
 # Release v3.3.3
 
 ## Highlights
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
index 5e66d0d89..9d3fa06aa 100644
--- a/docs/tutorials.rst
+++ b/docs/tutorials.rst
@@ -16,6 +16,15 @@ The source code is available in the folder
 .. _`docs/tutorials`:
    https://github.com/IAMconsortium/pyam/tree/main/docs/tutorials
 
+Computing derived timeseries
+----------------------------
+
+To derive new timeseries from existing data, start with the
+:doc:`algebraic operations tutorial <tutorials/algebraic_operations>`, which
+covers adding, subtracting, multiplying and dividing data. For higher-level
+indicators such as shares, quantiles, growth rates and learning rates, see the
+:doc:`derived timeseries API <api/compute>`.
+
 .. toctree::
    :maxdepth: 1
 

From 48a6a5b56fbfc85368daf48d4d820c4e55952f82 Mon Sep 17 00:00:00 2001
From: JSap0914 <JSap0914@users.noreply.github.com>
Date: Mon, 13 Jul 2026 17:20:04 +0900
Subject: [PATCH 2/2] Link release notes to #988

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9b8c0063b..fcd10eb0a 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -2,7 +2,7 @@
 
 ## Individual updates
 
-- [#984](https://github.com/IAMconsortium/pyam/issues/984) Highlight documentation
+- [#988](https://github.com/IAMconsortium/pyam/pull/988) Highlight documentation
   for computing derived timeseries data
 
 # Release v3.3.3