Skip to content

Conversation

@colleenmcginnis
Copy link
Contributor

🍷 Pairs with elastic/elastic-agent-changelog-tool#213 elastic/elastic-agent#9440

What is the problem this PR solves?

Currently the Elastic Agent Control Plane team generates release notes in AsciiDoc in this repo and the @elastic/ingest-docs team has to manually translate AsciiDoc to Markdown, copy to another repo (docs-content), split into multiple files, and integrate with Elastic Agent release notes. This is time consuming for the docs team and often leads to delays in publishing release notes.

How does this PR solve the problem?

In elastic/elastic-agent-changelog-tool#213, I updated the automation to allow generating Markdown, formatting it, and putting it into the correct files directly using elastic-agent-changelog-tool. This is the fleet-server output when generating the release notes using the colleenmcginnis:markdown branch of elastic-agent-changelog-tool.

This PR adds generated Markdown Fleet Server release notes here instead in the docs-content repo.

How to test this PR locally

This repo is not currently hooked up to the docs build system so we don't have a PR preview yet, but you can build the docs locally.

Screenshot 2025-08-29 at 10 54 24 AM

Note: Right now it will build independently from the rest of the Release notes, but once this repo is hooked up to the docs build system, these release notes will be integrated into the larger Release notes table of contents.

Design Checklist

This is a docs-only change.

Checklist

This is a docs-only change.

Related issues

cc @ebeahan @pierrehilbert @bmorelli25

@colleenmcginnis colleenmcginnis self-assigned this Aug 29, 2025
@colleenmcginnis colleenmcginnis added documentation Improvements or additions to documentation docs Team:Docs Label for the Observability docs team skip-changelog labels Aug 29, 2025
@prodsecmachine
Copy link

prodsecmachine commented Aug 29, 2025

🎉 Snyk checks have passed. No issues have been found so far.

security/snyk check is complete. No issues have been found. (View Details)

license/snyk check is complete. No issues have been found. (View Details)

@mergify
Copy link
Contributor

mergify bot commented Aug 29, 2025

This pull request does not have a backport label. Could you fix it @colleenmcginnis? 🙏
To fixup this pull request, you need to add the backport labels for the needed
branches, such as:

  • backport-./d./d is the label to automatically backport to the 8./d branch. /d is the digit
  • backport-active-all is the label that automatically backports to all active branches.
  • backport-active-8 is the label that automatically backports to all active minor branches for the 8 major.
  • backport-active-9 is the label that automatically backports to all active minor branches for the 9 major.

@github-actions
Copy link
Contributor

github-actions bot commented Sep 4, 2025

🔍 Preview links for changed docs

ebeahan
ebeahan previously approved these changes Sep 4, 2025
@mergify
Copy link
Contributor

mergify bot commented Sep 5, 2025

This pull request is now in conflicts. Could you fix it @colleenmcginnis? 🙏
To fixup this pull request, you can check out it locally. See documentation: https://help.github.com/articles/checking-out-pull-requests-locally/

git fetch upstream
git checkout -b add-markdown-release-notes upstream/add-markdown-release-notes
git merge upstream/main
git push upstream add-markdown-release-notes

@elastic-sonarqube
Copy link

Quality Gate passed Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarQube

@colleenmcginnis colleenmcginnis merged commit b73980b into elastic:main Sep 10, 2025
13 checks passed
@colleenmcginnis colleenmcginnis deleted the add-markdown-release-notes branch September 10, 2025 19:11
colleenmcginnis added a commit to elastic/docs-content that referenced this pull request Sep 11, 2025
…elease notes (#2818)

Related to elastic/docs-projects#488
elastic/elastic-agent-changelog-tool#213,
elastic/elastic-agent#9440,
elastic/fleet-server#5374

⚠️ **DO NOT MERGE BEFORE
elastic/docs-builder#1830 IS BOTH MERGED AND
INCLUDED IN A NEW RELEASE** ⚠️

Removes the combined Fleet Server and Elastic Agent release notes in
favor of separate release notes in the fleet-server and elastic-agent
repos. This enables the dev team to own the release notes process.
@karenzone karenzone added backport-9.0 Automated backport to the 9.0 branch backport-9.1 Automated backport to the 9.1 branch labels Sep 16, 2025
mergify bot pushed a commit that referenced this pull request Sep 16, 2025
* copy over changelog yaml files

* render release notes, make them publishable

(cherry picked from commit b73980b)

# Conflicts:
#	docs/docset.yml
#	docs/release-notes/index.md
#	docs/release-notes/toc.yml
mergify bot pushed a commit that referenced this pull request Sep 16, 2025
* copy over changelog yaml files

* render release notes, make them publishable

(cherry picked from commit b73980b)

# Conflicts:
#	docs/docset.yml
#	docs/release-notes/index.md
#	docs/release-notes/toc.yml
ebeahan pushed a commit that referenced this pull request Sep 16, 2025
* [docs] Add Markdown release notes (#5374)

* copy over changelog yaml files

* render release notes, make them publishable

(cherry picked from commit b73980b)

# Conflicts:
#	docs/docset.yml
#	docs/release-notes/index.md
#	docs/release-notes/toc.yml

* remove references to 9.1.x

---------

Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co>
colleenmcginnis added a commit that referenced this pull request Sep 16, 2025
* copy over changelog yaml files

* render release notes, make them publishable

(cherry picked from commit b73980b)

# Conflicts:
#	docs/docset.yml
#	docs/release-notes/index.md
#	docs/release-notes/toc.yml

Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-9.0 Automated backport to the 9.0 branch backport-9.1 Automated backport to the 9.1 branch docs documentation Improvements or additions to documentation skip-changelog Team:Docs Label for the Observability docs team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants