From b3bc853bd1a7229e55e6cea43b67cdc90443c9ac Mon Sep 17 00:00:00 2001
From: Yurii Bakurov <45154988+Yurii201811@users.noreply.github.com>
Date: Thu, 16 Jul 2026 17:15:31 +0200
Subject: [PATCH 1/2] Document adaptive scheduler metadata (#2001)

---
 docs/src/main/asciidoc/internals.adoc | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/src/main/asciidoc/internals.adoc b/docs/src/main/asciidoc/internals.adoc
index f4287fc9a..a7e9bc243 100644
--- a/docs/src/main/asciidoc/internals.adoc
+++ b/docs/src/main/asciidoc/internals.adoc
@@ -56,9 +56,17 @@ scheduler.adaptive.fetchInterval.min: 60
 scheduler.adaptive.fetchInterval.max: 20160
 scheduler.adaptive.fetchInterval.rate.incr: .5
 scheduler.adaptive.fetchInterval.rate.decr: .5
+
+metadata.persist:
+  - signature
+  - fetch.statusCode
+  - fetchInterval
+  - signatureChangeDate
+  - last-modified
+  - protocol.etag
 ----
 
-The `AdaptiveScheduler` requires the `MD5SignatureParseFilter` to be configured so that the `signature` metadata field is populated.
+The `AdaptiveScheduler` requires the `MD5SignatureParseFilter` to be configured so that the `signature` metadata field is populated. The scheduler also persists its current `fetchInterval` and the metadata used to detect content changes. The `last-modified` and `protocol.etag` fields allow conditional requests when `scheduler.adaptive.setLastModified` is enabled.
 
 
 === Bolts

From e20cbca60dee46a8b0c77c6505f300ca69a5c5b3 Mon Sep 17 00:00:00 2001
From: Yurii Bakurov <45154988+Yurii201811@users.noreply.github.com>
Date: Fri, 17 Jul 2026 10:44:21 +0200
Subject: [PATCH 2/2] #2001 Clarify conditional request metadata

---
 docs/src/main/asciidoc/internals.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/main/asciidoc/internals.adoc b/docs/src/main/asciidoc/internals.adoc
index a7e9bc243..7dc32d5c5 100644
--- a/docs/src/main/asciidoc/internals.adoc
+++ b/docs/src/main/asciidoc/internals.adoc
@@ -66,7 +66,7 @@ metadata.persist:
   - protocol.etag
 ----
 
-The `AdaptiveScheduler` requires the `MD5SignatureParseFilter` to be configured so that the `signature` metadata field is populated. The scheduler also persists its current `fetchInterval` and the metadata used to detect content changes. The `last-modified` and `protocol.etag` fields allow conditional requests when `scheduler.adaptive.setLastModified` is enabled.
+The `AdaptiveScheduler` requires the `MD5SignatureParseFilter` to be configured so that the `signature` metadata field is populated. The scheduler also persists its current `fetchInterval` and the metadata used to detect content changes. The `last-modified` field (written when `scheduler.adaptive.setLastModified` is enabled) and `protocol.etag` allow conditional requests (`If-Modified-Since` / `If-None-Match`).
 
 
 === Bolts