Skip to content

Conversation

@shainaraskas
Copy link
Contributor

@shainaraskas shainaraskas commented Oct 24, 2025

Update the tutorial we have for bumping a version in docs v3

After we have this centralized tutorial, we can cut down on steps in templates so we can reduce the # of surfaces that need to be updated when this process is enhanced (e.g. https://github.com/elastic/dev/pull/3321, https://github.com/elastic/dev/pull/3326, +++++)

Also fixed some stray references to including the base version in the legacy versions array (no longer needed as of #1865)

@github-actions
Copy link

github-actions bot commented Oct 24, 2025

@shainaraskas shainaraskas added the documentation Improvements or additions to documentation label Oct 24, 2025
@shainaraskas
Copy link
Contributor Author

@reakaleek can you spot check my changes please? :)

@shainaraskas shainaraskas marked this pull request as draft October 30, 2025 15:46
@shainaraskas
Copy link
Contributor Author

shainaraskas commented Nov 13, 2025

Updated the procedure based on our experience with the ECE + ECK releases:

  • only docs-engineering can approve and merge the config changes in staging and prod
  • the version bump PR must be held until release day. if it is merged early, it blocks all other version bumps and bumps of docs-builder features

as a result, I split the process into two phases:

  • prep (config-related PRs in docs-builder)
  • release day (merging the config changes, shepherding the changes into staging and prod)

@Mpdreamz please take a look :)

@shainaraskas shainaraskas marked this pull request as ready for review November 13, 2025 18:59
@Mpdreamz
Copy link
Member

Like the prep/release day separation, thanks @shainaraskas !

@shainaraskas shainaraskas merged commit e71bd65 into main Nov 20, 2025
24 checks passed
@shainaraskas shainaraskas deleted the release-refresh branch November 20, 2025 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants