docs-builder release notes

Allow a DRA release with no changelog entries. #4535
API Explorer: capitalize plain lowercase tag names when x-displayName is absent. #4534
Report unknown frontmatter keys as hints, not errors. #4536

1.66.0

Released: October 21, 2026

Features and enhancements

List header parameters on API Explorer operation pages. #4436
Fail breaking-change PRs that lack Impact and Action. #4444
Move YAML to SharpYaml and report unknown keys as errors. #4506
Stop showing spec type names in the API Explorer. #4429
Open one API response at a time and sync it with the examples rail. #4439
Show a copyable Base URL and version on API product landings. #4428
Link API path placeholders to their parameter docs. #4441
Strip conventional-commit title prefixes and capitalize titles. #4445
API Explorer: highlight curl JSON bodies and variables. #4450
API Explorer: highlight braced variables in curl samples. #4453
Rename the API operation "Request" heading to "Request body". #4449
API Explorer: generate runnable Console and curl samples for operations without x-codeSamples. #4446
Show meaningful examples on API Explorer parameters. #4456
Bundle the original pull request instead of its backport. #4465
Redesign the hub get-started section and refine hub pages. #4438
Fetch changelog entries and pull requests in parallel. #4466
Skip products without changelogs when bundling unified release notes. #4467
Log the decisions of a range bundle in batches. #4472
Changelog.yml: let a product label imply other products. #4469
Read the pull requests of a range 50 at a time through GraphQL. #4476
Cache what a commit range learns from GitHub between runs. #4480
Render x-beta API operations with the shared lifecycle badge. #4479
Show array bodies of objects as a tree under an array row. #4485
Flash the API target a fragment lands on. #4484
Group the API product switcher like the catalog page. #4488
List the discriminator property first in API union variants. #4490
Let API union variants fold their fields behind a toggle. #4491
API docs: keep the method badge on the first line of a wrapped path. #4489
Give each version of the unified release notes preview its own page. #4486
Leave a primitive variant's panel empty behind a union chip. #4494
Nest release note sections under each version. #4505
Show open API nodes as nested boxes instead of guide lines. #4493
Scroll long enum value lists on API pages. #4508
Search long API union variant lists from the chip row. #4500
Focus the API search box when "/" is pressed. #4511
Show a readable title for API operations that fall back to the operationId. #4516
Show lifecycle badges on API group overview rows. #4520
Drop the API license fact from the API landing page. #4527
Add the Elastic Agent package and hold private DRA products. #4533

Fixes

Open collapsed rows when an API reference in-page link is clicked. #4431
API Explorer: serve JSON and YAML specs with explicit types. #4430
Fix spec Content-Type leaking onto other S3 uploads. #4433
Add space between the endpoint path and the operation description. #4440
Show map values, object fields and x-state badges on query parameters. #4435
Hide readOnly fields from API Explorer requests and fix markdown and ids. #4442
Rename the API path parameters anchor to path-params. #4448
Fix the validate-only comment and the config link in changelog PR comments. #4452
Stop saying an entry was generated in the validate-only Impact and Action comment. #4454
API docs: move the operation Base URL to the right rail. #4447
Keep backticks in spec text from breaking API Explorer markdown. #4458
Add space between the API catalog hero and the first group. #4457
Style links in hub section intros. #4468
Fix broken .md links in hub section text. #4470
Retry transient GitHub GraphQL failures instead of crashing the run. #4471
Retry GitHub's internal GraphQL error and send lighter range queries. #4475
Align the copy-link button with the first response property. #4463
Make API response status chips the same width. #4464
Show API example descriptions next to the request or response they describe. #4483
API Explorer: list the fields of map request and response bodies. #4482
Make collapsed fields on API type pages findable with find-in-page. #4502
Show the union type on query and header parameters. #4501
API pages: show the feedback prompt last on mobile. #4492
Name referenced API union variants by their schema. #4509
Title API operations by operationId when the summary is blank. #4515
Drop the duplicate "(map)" prefix from map type pages. #4518
Color a named "union" type like the union keyword in API parameters. #4521
Style code in API example descriptions like the rest of the page. #4524
Keep the API feedback prompt below a tall examples rail on wide screens. #4525
Step API landing headings below the title and space the index. #4526
Strip blockquote markers from extracted release notes. #4531

1.65.0

Released: October 13, 2026

Features and enhancements

Make API Explorer parameter names selectable. #4425
Show API availability with the shared applies_to badge. #4422

Fixes

API docs: keep Back and Forward working after picking an example. #4427

1.64.0

Released: October 13, 2026

Features and enhancements

Add release unified build to render DRA release notes. #4397
Add meta_title frontmatter override. #4421
Show a property's reference link above its show properties toggle. #4377
Read single-or-array rows as "Rescore or Rescore[]". #4380
Flag nullable fields and drop options rows that repeat the type. #4381
Render spec callouts as admonitions on API reference pages. #4388
Show the x-state label beside API operation titles. #4392
API examples: activate the language card that find-in-page reveals. #4379
API docs: match description text to docs page typography. #4396
Show required authorization and authentication inline on API operations. #4393
Add Beats and Elastic Agent icons for hub pages. #4394
Collapse every parameter section on API operation pages. #4406
API Explorer: copy the property link when its icon is clicked. #4385
Bundle DRA release notes from the commit range between manifests. #4408
Pick union variants from chips when a list has two or more. #4371
Show array types as string[] and name what min/max bound in API Explorer. #4415
Explain %20 links and unpublished file links in diagnostics. #4417
Remove the outer side padding from the API page shell on wide screens. #4416
Hide the Servers page from API Explorer navigation. #4419

Fixes

API Explorer: use sentence case for section headings. #4386
Name the entry bundle by content hash so it loads once. #4389
Keep recent builds' hashed frontend assets in the bucket on deploy. #4390
Convert every bump.sh callout kind on API reference pages. #4391
Link API catalog and product roots without a trailing slash. #4265
Slide the API examples rail instead of snapping it. #4399
Layout: load elastic-nav.js with defer. #4401
Keep Serverless API cards attached to their parent on narrow screens. #4400
Report outages and shadowed configs in release unified bundle. #4398
Show the dominant HTTP method in the API sidebar badge. #4403
API docs: collapse param sections without forced reflows. #4405
Let release unified bundle write outside the git root. #4404
Stop the frontend watch from rebuilding in a loop. #4407
API docs: fix the "N more" badge in collapsed param summaries. #4410

1.63.0

Released: October 9, 2026

Features and enhancements

Add an on-this-page directive for hub pages. #4335
Add DRA unified release-notes bundle command with current/preview resolution. #4244
Refresh API Explorer pages on code and asset changes in serve. #4321
Speed up API page regeneration in serve to under 4 seconds. #4322
API pages: use the docs breadcrumb. #4216
Add a collapsed option to the explore directive. #4331
Add a heading level option to the explore directive. #4334
Use tippy tooltips on the API copy buttons. #4333
Remove the raw tag name from API group pages. #4350
Use Swagger colors and theme tokens for API method badges. #4351
API nav: show HTTP verbs as text on the right of each row. #4262
API examples: collapse extra chips into a "+N more" menu. #4353
Style API reference links like regular docs links. #4356
API landing: show endpoints as a grouped index. #4355
Show the information API reference hides in oneOf, anyOf and allOf. #4327
Add hidden release serverless bundle command. #4330
Label nested union lists and apply body union rules on schema pages. #4368
Say when a field also accepts an array of its type. #4370
Give ingest processors their own page and link type pages by schema id. #4376

Fixes

Show API pages under short product URLs in ./dev.sh serve. #4316
Fix the hub get-started heading and start-local code box. #4332
Install npm packages once on dev.sh isolated-serve. #4340
Step down accordion titles under a nested explore section. #4348
Correct HTTP method colors on API pages. #4270
Show required fields, alias names and missing types in API Explorer rows. #4360
Keep the pointer cursor on API catalog deployment tags. #4362
Lay out API responses as status, description and media type. #4363
API Explorer: render fenced code in descriptions as the default code block. #4365
Collapse object parameters by default. #4267
Show required field sets and hidden Fleet map values in API Explorer. #4364
Center API pages next to a left-pinned nav. #4366
API docs: save the language only when the reader picks it. #4369
Truncate long constraints on API property rows. #4374
Set the Serverless product pair on every release serverless entry. #4378

1.62.2

Released: October 5, 2026

Fixes

Downgrade Mermaider to 0.12.2 to fix Mermaid rendering. #4308

1.62.1

Released: October 5, 2026

Fixes

Bump Mermaider to 0.14.1. #4310

1.62.0

Released: October 5, 2026

Features and enhancements

Enable the API explorer in the edge environment. #4289
[Prototype] {table} :filterable: option — search + auto-facets. #4130
Share code block styling and behaviour with the API explorer. #4295
Limit API group intros to the docs reading measure. #4293
Show API endpoints as a code chip and copy alternative paths. #4296

Fixes

Show full response descriptions and make the whole summary clickable. #4261
Make API section headings anchor links like docs headings. #4264
Keep the request example visible in the API examples rail. #4292
Keep API operation columns still when content expands. #4286
API reference: show a response example from the spec. #4284
Replace the API operation grid with stacked flex columns. #4283
Show API auth schemes as outlined buttons with an icon. #4274
Match operation headings to h1, h2, then h3. #4277
Place the API spec menu below its trigger. #4280
Match string type chips in query parameters and request bodies. #4279

1.61.0

Released: October 1, 2026

Features and enhancements

Move nav method glyphs into the SVG sprite sheet. #4237

Fixes

Use a dedicated pipeline for changelog-generated markdown. #4231
Honor externalDocs.description on API reference pages. #4248
Show request examples on API operation pages that have code samples. #4253
Show every enum value on API reference pages. #4250
Label the API switcher with each spec title. #4257
Show string and array types on path parameters. #4258
Show operation summaries in API search hits. #4259
Guard YAML parsing against unknown properties and release-notes values. #4245
Name the path parameter heading Path Parameters. #4251
Open the API nav to the current operation. #4260
Raise contrast of API links, selectors, and copy buttons. #4285

1.60.1

Released: September 25, 2026

Fixes

Hint when release note descriptions are incomplete. #4196
Sanitize API description HTML and fix search-index word-boundary collapse. #4199
Fix Swagger 2.0 spec ingestion and upgrade Microsoft.OpenApi to 3.10.2. #4219
Fix ECE API ingestion blocked by {{hostname}} template placeholder. #4223

1.60.0

Released: September 22, 2026

Features and enhancements

Add bundle.releases config to map release triggers to profiles. #4178
Add a stepper option that keeps step titles out of the page outline. #4181
Give API pages unique titles, descriptions, and breadcrumb JSON-LD. #4193
Show linked auth scheme pills on API operation pages. #4195
API Explorer: omit empty authentication and servers pages. #4118
Cache OpenAPI $ref resolution per schema instead of re-resolving on every property access. #4171
Fan out API product and version rendering across all available cores. #4172

Fixes

Fix API operation links that keep a .json suffix. #4187
Eliminate double page-model build in the API explorer. #4170
Fix gh-release output path and first-release fallback. #4168
Render Jump to search without waiting for API health. #4189
Render OAS description HTML in the API Explorer. #4190

1.59.0

Released: September 22, 2026

Features and enhancements

Feat: add Docker dev support for the MCP server via ./dev.sh. #4132
Feat: add Docker dev support for the docs API via ./dev.sh. #4138
Mount Jump to API in the assembler API sidebar. #4145
Add more related learning links. #4134
[Release notes] Update changelog bundle description without re-bundling. #4125
Add --no-overwrite option to changelog upload. #4136
API catalog: show the product mark on spec landing pages. #4069
Accept API hits in navigation-search schemas. #4143
Let navigation-search filter by a type attribute. #4144
Show API-shaped Jump to page rows and telemetry. #4147
Polish Jump to API search rows and dropdown chrome. #4153

Fixes

Fix: render API operation path list with styled HTTP method badges. #4142
Index OpenAPI specs published from a master branch. #4131
Fix: route API sidebar links through HTMX instead of full page reload. #4155
Landing page: hide the empty mobile hamburger. #4068
Reserve space for applies-to badges before they hydrate. #3790
Warn instead of error when a products.yml product has no CDN bundles yet. #4161
Fix ARG_MAX crash on large PRs in docs-preview-local workflow. #4156

Documentation

[DOCS] Describe workflow for amending changelog bundle notes. #4073
Add log essentials and edit related link titles in related-learning.yml. #4135

1.58.0

Released: September 17, 2026

Features and enhancements

MInor wording changes to vector sizing calculator. #4050
Add fork contributor guidance to the missing-entry changelog comment. #4113
Validate changelog entry filename PR numbers against product repos. #4117
Feat: add Docker dev environment via ./dev.sh. #4076
CTA: register default templates on docset.yml and toc.yml. #3716
Make FetchPreviousTagAsync semver-aware with tags-API fallback and early-bail. #4094
Emit bundle_path output from changelog gh-release and bundle. #4102
Stop pre-scrubbing bundles at create time; obsolete link_allow_repos. #4105
Allow default_cta on file and folder navigation entries. #4100
Match API Explorer sidebar to bump.sh. #4111
Fix: MCP server metadata: name, version, and protocol version. #4112

Fixes

Fix typo in ChangelogFileWriter.cs. #4091
Drop release-body parsing; use GitHub commit-range and generate-notes for PRs. #4092
Return success when all PRs in a release are excluded by label rules. #4098
Replace pool registry fetch with per-PR CDN probe in gh-release mode. #4106
Emit a hard error when a bare scalar appears as a toc entry. #4109
Feat: {changelog} directive — product argument, CDN-first, since_version filter. #4110
[Release notes] Make BundleLoader use BundleAmendMerger parent paths. #4104
Include available labels in CI console error messages for missing type/product label. #4114
Auto-infer CDN product from repo; best-effort fetch, hint on 404. #4115

Documentation

Docs: add settings YAML description, default, and lifecycle rules. #4101