Skip to content
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

Fixes #18733: Add Dependency Version Matrix for NetBox Versions to the Upgrade Documentation #19046

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

pheus
Copy link
Contributor

@pheus pheus commented Apr 1, 2025

Fixes: #18733

Summary

This PR introduces a dependency version matrix to the Upgrade Guide, providing a structured reference for verifying compatibility before upgrading. The matrix outlines the supported versions of Python, PostgreSQL, and Redis for each NetBox release, helping users avoid installation issues due to unsupported dependencies.

Changes

  • Added a toggleable version matrix to the upgrade guide, allowing users to switch between Current Version and All Versions instead of the initially proposed Current Version and Previous Versions. This makes it clearer and more useful for users looking for historical compatibility data.
  • Ensures that system requirements for each NetBox version are clearly documented in one place.

Screenshots

Screenshot 2025-04-01 at 08-54-46 Upgrading NetBox - NetBox Documentation

Screenshot 2025-04-01 at 08-55-17 Upgrading NetBox - NetBox Documentation

Would love any feedback on placement or formatting! 🚀

Adds a dependency matrix to the upgrade guide, detailing supported
Python, PostgreSQL, and Redis versions for each NetBox release. This
helps users verify compatibility before upgrading.

Fixes netbox-community#18733
@pheus
Copy link
Contributor Author

pheus commented Apr 1, 2025

I'd like to point out that I targeted the main branch. If this PR gets merged into the feature branch instead, we should consider #18909, as that PR raises the minimum PostgreSQL version to 14.

Looking forward to your feedback, @jnovinger!

@jeremystretch jeremystretch requested review from a team and bctiemann and removed request for a team April 1, 2025 15:18
@jeremystretch
Copy link
Member

The documentation for cutting a new minor release should also be updated with instructions for updating the matrix.

pheus added 2 commits April 2, 2025 21:41
Add steps to update the dependency requirements matrix for each minor
release in the release checklist. Clarify how to document changes for
system requirements and linked installation guides.

Fixes netbox-community#18733
@pheus
Copy link
Contributor Author

pheus commented Apr 2, 2025

Thanks for the feedback, @jeremystretch! That makes sense. I'll update the documentation for cutting a new minor release to include instructions for maintaining the matrix.

@pheus
Copy link
Contributor Author

pheus commented Apr 2, 2025

I've added instructions for updating the dependency requirements matrix to the release documentation. Let me know if any refinements are needed!
In the third commit, I made some smaller adjustments - if you don't find them useful, feel free to drop that commit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add a Version Requirements Matrix to the NetBox Upgrade Documentation
2 participants