You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The purpose of a changelog is to log or record notable changes.
12
+
The purpose of a changelog is to log or record notable changes, which then appear as part of the [Cloudflare changelog](/changelog/) and on product-specific changelog pages.
9
13
10
14
## Tone
11
15
@@ -21,199 +25,110 @@ For more details, refer to [`pcx_content_type`](/style-guide/frontmatter/custom-
21
25
22
26
## Ownership
23
27
24
-
Developers and engineers maintain changelogs manually or via an automated process that their team owns. PCX provides a review but should not own creating or writing changelogs.
25
-
26
-
The structure of the page can differ depending on the frequency or type of page.
27
-
28
-
:::note
28
+
Product managers and engineers maintain changelogs manually or via an automated process that their team owns. PCX provides a review but should not own creating or writing changelogs.
29
29
30
-
Do not use the following terms: change log (two words), release notes, what's new, or README.
30
+
## Structure
31
31
32
-
"What's New"is a specific [content type](https://www.cloudflare.com/whats-new/) for marketing communication.
33
-
:::
34
-
35
-
## Structure (single-page)
36
-
37
-
When creating a changelog, you need an MDX page file and a corresponding YAML file in the [`src/content/changelogs` folder](https://github.com/cloudflare/cloudflare-docs/tree/production/src/content/changelogs).
32
+
When creating a changelog, you need an MDX page file and a corresponding folder of changelog entries.
38
33
39
34
The combination of these files allows us to:
40
35
41
-
- Render traditional changelog content on an [HTML page](/stream/changelog/).
42
-
- Programmatically create an [RSS feed](/stream/changelog/index.xml) with the changelog content.
36
+
- Render traditional changelog content on an [HTML page](/dns/changelog/).
37
+
- Programmatically create an [RSS feed](/changelog/rss/dns.xml) with the changelog content.
43
38
- Pull all our changelog content into a [Cloudflare-wide changelog](/changelog/).
44
39
45
40
### Markdown file
46
41
47
42
Your Markdown file needs to have several special values to pull in the changelog information. These values are highlighted in the sample page.
import { ProductReleaseNotes } from "~/components";
50
+
import { ProductChangelog } from "~/components";
60
51
61
-
{/* <!-- Actual content lives in /src/content/release-notes/queues.yaml. Update the file there for new entries to appear here. For more details, refer to https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/changelog/#yaml-file --> */}
52
+
{/* <!-- Actual content lives in /src/content/changelog/dns/. --> */}
62
53
63
-
<ProductReleaseNotes />
54
+
<ProductChangelog product="dns" />
64
55
```
65
56
66
-
### YAML file
67
-
68
-
The `<ProductReleaseNotes>` component renders data that lives in a file within the [`/src/content/changelogs` folder](https://github.com/cloudflare/cloudflare-docs/tree/production/src/content/changelogs).
69
-
70
-
- `link`string required
71
-
72
-
- Relative path to the changelog page, such as `"/queues/changelog/"`.
73
-
74
-
- `productName`string required
75
-
76
-
- Product name to display on the [changelog](/changelog/) product filter list, as well as other areas of the template.
77
-
78
-
- `productLink`string required
79
-
80
-
- Link to top-level docs for your product (helpful for context if someone is landing on the top-level changelog page)
57
+
### Changelog entries
81
58
82
-
- `productArea`string required
59
+
Changelog entries live in a different location of our docs, [`/src/content/changelog/`](https://github.com/cloudflare/cloudflare-docs/tree/production/src/content/changelog).
83
60
84
-
- Rollup grouping to surface related products together in context.
61
+
Each entry will be it's own MDX file, similar to the following.
85
62
86
-
- `productAreaLink`string required
87
-
88
-
- Rollup grouping to surface related products together in context. Helps pull together related RSS feeds.
89
-
90
-
- `entries`object required
91
-
92
-
- `publish_date`date required
93
-
94
-
- Date of published change, formatted as `YYYY-MM-DD`.
95
-
96
-
- `title`string optional
97
-
98
-
- Name of published change. Optional, but highly encouraged.
99
-
100
-
- `description`string required
101
-
102
-
- Markdown string that also follows YAML conventions. For multi-line strings, start the entry with `|-` and then type on an indented new line.
Queue consumers will now [automatically scale up](/queues/learning/consumer-concurrency/)
116
-
based on the number of messages being written to the queue. To control or limit
117
-
concurrency, you can explicitly define a [`max_concurrency`](/queues/platform/configuration/#consumer)
118
-
for your consumer.
119
-
- publish_date: "2023-03-15"
120
-
title: Consumer concurrency (upcoming)
121
-
description: |-
122
-
Queue consumers will soon automatically scale up concurrently as a queues' backlog grows in order to keep overall message processing latency down. Concurrency will be enabled on all existing queues by 2023-03-28.
123
-
124
-
**To opt-out, or to configure a fixed maximum concurrency**, set `max_concurrency = 1` in your Wrangler file or via [the queues dashboard](https://dash.cloudflare.com/?to=/:account/queues).
125
-
126
-
**To opt-in, you do not need to take any action**: your consumer will begin to scale out as needed to keep up with your message backlog. It will scale back down as the backlog shrinks, and/or if a consumer starts to generate a higher rate of errors. To learn more about how consumers scale, refer to the [consumer concurrency](/queues/learning/consumer-concurrency/) documentation.
127
-
- publish_date: "2023-03-02"
128
-
title: Explicit acknowledgement (new feature)
129
-
description: |-
130
-
You can now [acknowledge individual messages with a batch](/queues/learning/batching-retries/#explicit-acknowledgement) by calling `.ack()` on a message.
131
-
132
-
This allows you to mark a message as delivered as you process it within a batch, and avoids the entire batch from being redelivered if your consumer throws an error during batch processing. This can be particularly useful when you are calling external APIs, writing messages to a database, or otherwise performing non-idempotent actions on individual messages within a batch.
133
-
- publish_date: "2023-03-01"
134
-
title: Higher per-queue throughput
135
-
description:
136
-
The per-queue throughput limit has now been [raised to 400 messages
137
-
per second](/queues/platform/limits/).
138
-
- publish_date: "2022-12-12"
139
-
title: Increased per-account limits
140
-
description:
141
-
Queues now allows developers to create up to 100 queues per account,
142
-
up from the initial beta limit of 10 per account. This limit will continue to
143
-
increase over time.
144
-
- publish_date: "2022-12-13"
145
-
title: sendBatch support
146
-
description:
147
-
The JavaScript API for Queue producers now includes a `sendBatch` method
148
-
which supports sending up to 100 messages at a time.
149
-
```
150
-
65
+
title: Account-level DNS analytics now available via GraphQL Analytics API
66
+
description: Authoritative DNS analytics can now be accessed on the account level via the GraphQL Analytics API.
67
+
date: 2025-06-19T12:00:00Z
151
68
---
152
69
153
-
## Structure (multi-page)
154
-
155
-
In some cases, your changelog may have a separate page for each entry. The general structure is the same as the [single-page changelog](#structure-single-page), but with a few small differences.
156
-
157
-
### Markdown files
158
-
159
-
#### Top-level pages
160
-
161
-
For the top-level pages, you need the same frontmatter as the [single-page example](#markdown-file), but do not include any shortcodes in the body of the page.
162
-
163
-
#### Individual entries
164
-
165
-
For each entry page, create a regular markdown page. These do not require a separate style of page or any adjustments.
166
-
167
-
### YAML file
168
-
169
-
Each individual entry needs an abbreviated entry in the changelog `.yaml` file.
Authoritative DNS analytics are now available on the **account level** via the [Cloudflare GraphQL Analytics API](/analytics/graphql-api/).
71
+
72
+
This allows users to query DNS analytics across multiple zones in their account, by using the `accounts` filter.
73
+
74
+
Here is an example to retrieve all DNS queries across all zones in an account that resulted in an `NXDOMAIN` response over a given time frame. Please replace `a30f822fcd7c401984bf85d8f2a5111c` with your actual account ID.
75
+
76
+
```graphql graphql-api-explorer title="GraphQL example for account-level DNS analytics"
- Date when the page was published, formatted as `YYYY-MM-DD`. For pages with scheduled changes, you should update this field when adding/updating entries, so that the changelog item gets placed at the top of the changelog list (and feed). You should _not_ update this date when clearing all scheduled changes due to a release, since this change is not as relevant.
192
-
193
-
- `individual_page`boolean required
194
-
195
-
- Used to pull in the content from the page itself, as opposed to structured data in YAML.
196
-
197
-
- `link`string required
198
-
199
-
- Link to the individual page.
200
-
201
-
- `scheduled`boolean optional
202
-
203
-
- Should be included for scheduled pages. Because this component renders content on the underlying page, you should only have a) one scheduled entry per scheduled entry page and b) only a scheduled entry when the scheduled entry page has content.
204
-
205
-
- `scheduled_date`date required
206
-
207
-
- Should be included for pages with scheduled changes. Helps render the date of the upcoming change in the title, which provides more actionable information to folks scanning titles or the associated RSS feeds.
208
-
209
-
:::note
210
-
211
-
If the scheduled date gets pushed for a change, update the `publish_date` and `scheduled_date` fields of the changelog entry. This process makes sure customers will receive notifications via their RSS feeds.
212
-
213
-
:::
214
-
215
-
## Examples
216
-
217
-
- [Stream Changelog](/stream/changelog/)
218
-
- [Pages Changelog](/pages/platform/changelog/)
219
-
- [WAF Changelog](/waf/change-log/)
100
+
To learn more and get started, refer to the [DNS Analytics documentation](/dns/additional-options/analytics/#analytics).
101
+
````
102
+
103
+
#### Properties
104
+
105
+
Each changelog entries has the following properties:
- The products list is case-sensitive. Only use lowercase.
118
+
- This should be an array of strings, each referring to the name of a file in the products collection without the file extension.
119
+
- The folder that your entry is in, such as `src/content/changelog/workers/2025-02-13-new-product-feature.mdx`, is inferred as part of this property. If you do not want to associate the entry with additional products, you can omit it from the frontmatter entirely.
120
+
- If you wish to reference a product that does not exist in this collection, such as one that resides in the subpath of an existing product, you can create a "metadata only" entry:
0 commit comments