Wiki update: Steeltoe support policy#1
Conversation
167d89e to
bd69d4c
Compare
bd69d4c to
bc03ccc
Compare
| | 4.1.0 | | January 30, 2026 | | .NET 8 - 10 | | ||
| | 4.0.0 | | September 4, 2025 | | .NET 8 - 9 | | ||
| | **Steeltoe 3** | Active | August 21, 2020 | September 4, 2026 | | | ||
| | 3.3.0 | | September 4, 2025 | | .NET 6 - 8 [^1] | |
There was a problem hiding this comment.
What are you thinking about EOL for the 3.4 release? Should we special-case it now that it also bumps us up to net8 and support it until net8's EOL (November 10, 2026)?
There was a problem hiding this comment.
I don't think that makes sense. The rule "one year after the next major version" should provide sufficient time to upgrade. I wouldn't want to imply we'll keep supporting old releases as long as they target a framework that's still supported by Microsoft. Because if we were to release a hypothetical Steeltoe 5 in two months, that would also mean we'll keep Steeltoe 4 in support until .NET 10 is no longer supported. Our release dates and frequency don't align with .NET versions.
| There is a rare chance that we might be forced to break compatibility in a minor release, but we will be sure to be clear of our reasons for doing so. | ||
| | Steeltoe Version | Status | Release Date | End of Life Date | .NET Runtime Version | | ||
| | --- | --- | --- | --- | --- | | ||
| | **Steeltoe 4** | Active | September 4, 2025 | TBD | | |
There was a problem hiding this comment.
I'm hesitant about TBD with no date or commentary. Perhaps we should add a footnote that states it will be no earlier than Sep 2028, as originally stated?
There was a problem hiding this comment.
I initially had a date, but Cursor suggested using TBD there because the date is still unknown. It also rejected leaving it empty. Its guidance was based on what other OSS projects generally do.
Is it better now?
| @@ -1,18 +1,14 @@ | |||
| TEST | |||
There was a problem hiding this comment.
Is this TEST the only difference across these files from the live wiki?
There was a problem hiding this comment.
No, the diff in this PR shows all changes compared to live.
|
|
||
| When new versions of Steeltoe are released, they are tested with the latest supported versions of .NET. | ||
| It is recommended to run the latest patch version for the targeted Steeltoe release. | ||
| ### Security fixes and serious defect fixes |
There was a problem hiding this comment.
Fix/fixes is used a lot in this section... we could mix it up with "issues", "patches", etc.
Maybe slightly simpler as "Security issues and serious defects" for the header?
Updates to the Steeltoe support policy. Minor fixes in other markdown files.
The primary changes are:
This aligns with what Microsoft and most other .NET OSS projects do.
Under the old terms: