Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

docs: enhance upgrade guide with alert formatting and decision matrix #42381

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
luizcireno-crypto wants to merge 2 commits into github:main
base: main
Choose a base branch
Loading
from luizcireno-crypto:upgrade-guide-improvements

Conversation

@luizcireno-crypto
Copy link

@luizcireno-crypto luizcireno-crypto commented Jan 14, 2026

Summary

Enhances the "About upgrades to new releases" documentation for GitHub Enterprise Server.

Improvements Made

  • ✅ Added proper alert formatting with [!CAUTION], [!WARNING], [!IMPORTANT]
  • ✅ Created decision matrix table for release type selection
  • ✅ Enhanced procedural structure for upgrade methods
  • ✅ Added missing versions field to frontmatter
  • ✅ All changes follow GitHub docs style guide and content model

Benefits

  • Clearer safety warnings for users
  • Better upgrade decision guidance
  • Improved user experience per GitHub doc standards

File Changed

content/admin/overview/about-upgrades-to-new-releases.md

 

- Added proper [!CAUTION], [!WARNING], [!IMPORTANT] alerts
- Created decision matrix table for upgrade path selection
- Enhanced procedural structure with clear step-by-step methods
- Added missing versions field to frontmatter
- All changes follow GitHub docs style guide standards
@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Jan 14, 2026
Copy link
Contributor

github-actions bot commented Jan 14, 2026 •
edited
Loading

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
admin/overview/about-upgrades-to-new-releases.md ghes@ 3.19 3.18 3.17 3.16 3.15 3.14
ghes@ 3.19 3.18 3.17 3.16 3.15 3.14

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

 

- Fix versions field format from '- ghes' to 'ghes: *'
- Fix absolute URLs to relative paths
- Use data variable for product name in intro and headers
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /