From 42e50ab6090b572e21652b3e628502cc7034fd74 Mon Sep 17 00:00:00 2001 From: Tim Hess Date: Wed, 9 Sep 2026 13:38:00 -0500 Subject: [PATCH 1/3] for table contents that shouldn't wrap, add `white-space: nowrap` --- docs/docs/v4/welcome/whats-new.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/docs/v4/welcome/whats-new.md b/docs/docs/v4/welcome/whats-new.md index df8136aa..e163aa9e 100644 --- a/docs/docs/v4/welcome/whats-new.md +++ b/docs/docs/v4/welcome/whats-new.md @@ -1500,15 +1500,19 @@ The table above reflects the API surface as of the initial Steeltoe 4.0 release. #### Steeltoe.Security changes in 4.3 +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePolicies` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddOrgAndSpacePoliciesForMutualTls()` | Header-based certificate forwarding can be spoofed by any client | -| `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePoliciesForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Verify space/org in the incoming client certificate using mTLS forwarded by the Cloud Foundry Gorouter | +| `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePoliciesForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Verify space/org in the incoming client certificate using mTLS forwarded by the Cloud Foundry Gorouter | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddAppInstanceIdentityCertificate` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddAppInstanceIdentityCertificateForMutualTls()` | Header-based certificate injection can be spoofed by any client | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddAppInstanceIdentityCertificateForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Send app-identity certificate with outgoing HTTP requests using mTLS | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificate` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddClientCertificateForMutualTls(string)` | Header-based certificate injection can be spoofed by any client | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificateForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Send custom certificate with outgoing HTTP requests using mTLS | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1525 From 6a639851059d591034fc22e4a0d113b99691e839 Mon Sep 17 00:00:00 2001 From: Tim Hess Date: Wed, 9 Sep 2026 14:28:25 -0500 Subject: [PATCH 2/3] promote to page-level style --- docs/docs/v4/welcome/whats-new.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/docs/v4/welcome/whats-new.md b/docs/docs/v4/welcome/whats-new.md index e163aa9e..aa86e4f3 100644 --- a/docs/docs/v4/welcome/whats-new.md +++ b/docs/docs/v4/welcome/whats-new.md @@ -1,3 +1,9 @@ + + # What's new in Steeltoe 4 ## Overview @@ -1500,19 +1506,15 @@ The table above reflects the API surface as of the initial Steeltoe 4.0 release. #### Steeltoe.Security changes in 4.3 -
- | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePolicies` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddOrgAndSpacePoliciesForMutualTls()` | Header-based certificate forwarding can be spoofed by any client | -| `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePoliciesForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Verify space/org in the incoming client certificate using mTLS forwarded by the Cloud Foundry Gorouter | +| `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePoliciesForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Verify space/org in the incoming client certificate using mTLS forwarded by the Cloud Foundry Gorouter | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddAppInstanceIdentityCertificate` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddAppInstanceIdentityCertificateForMutualTls()` | Header-based certificate injection can be spoofed by any client | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddAppInstanceIdentityCertificateForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Send app-identity certificate with outgoing HTTP requests using mTLS | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificate` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddClientCertificateForMutualTls(string)` | Header-based certificate injection can be spoofed by any client | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificateForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Send custom certificate with outgoing HTTP requests using mTLS | -
- ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1525 From 3f41bd998d8e2ce5a75e63dcdf56a46e4a6ac310 Mon Sep 17 00:00:00 2001 From: Tim Hess Date: Thu, 10 Sep 2026 09:52:39 -0500 Subject: [PATCH 3/3] switch to built-in class from bootstrap, set no-wrap per-table --- docs/docs/v4/welcome/whats-new.md | 42 ++++++++++++++++++++++++++----- 1 file changed, 36 insertions(+), 6 deletions(-) diff --git a/docs/docs/v4/welcome/whats-new.md b/docs/docs/v4/welcome/whats-new.md index aa86e4f3..2e3712ad 100644 --- a/docs/docs/v4/welcome/whats-new.md +++ b/docs/docs/v4/welcome/whats-new.md @@ -1,9 +1,3 @@ - - # What's new in Steeltoe 4 ## Overview @@ -165,11 +159,15 @@ The following sections provide details on the changes per Steeltoe component, as ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Bootstrap.Autoconfig.SteeltoeAssemblies` | Type | Steeltoe.Bootstrap.Autoconfig | Renamed | `Steeltoe.Bootstrap.AutoConfiguration.SteeltoeAssemblyNames` | Updated members to new/changed assembly names | | `Steeltoe.Connector` | Namespace | Steeltoe.Bootstrap.Autoconfig | Removed | None | Type locators have been replaced with internal-only shims | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1434 @@ -207,6 +205,8 @@ For more information, see the updated [Bootstrap documentation](../bootstrap/ind ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Microsoft.Extensions.DependencyInjection.ConfigurationServiceInstanceProviderServiceCollectionExtensions.AddConfigurationDiscoveryClient` | Extension method | Steeltoe.Common [Abstractions] | Moved | Steeltoe.Discovery.Configuration package | | @@ -298,6 +298,8 @@ For more information, see the updated [Bootstrap documentation](../bootstrap/ind | `Steeltoe.Common.Security.PemCertificateSource` | Type | Steeltoe.Common.Security | Removed | Store certificate paths in `IConfiguration` | Refactored to use ASP.NET Options pattern | | `Steeltoe.Common.Security.PemConfigureCertificateOptions` | Type | Steeltoe.Common.Security | Removed | Store certificate paths in `IConfiguration` | Refactored to use ASP.NET Options pattern | +
+ [^1]: When using the binary buildpack, specify port bindings in an [environment variable](https://learn.microsoft.com/aspnet/core/fundamentals/servers/kestrel/endpoints#specify-ports-only) or on the command-line: `--urls=http://0.0.0.0:%PORT%`. ### Notable PRs @@ -352,6 +354,8 @@ For more information, see the updated [Bootstrap documentation](../bootstrap/ind ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Configuration.ICompositeConfigurationSource` | Type | Steeltoe.Configuration.Abstractions | Added | | Building block for configuration providers | @@ -437,6 +441,8 @@ For more information, see the updated [Bootstrap documentation](../bootstrap/ind | `Steeltoe.Extensions.Configuration.SpringBoot.SpringBootEnvSource` | Type | Steeltoe.Extensions.Configuration.SpringBoot [Base/Core] | Removed | None | Renamed to internal `SpringBootEnvironmentVariableSource` | | `Steeltoe.Extensions.Configuration.SpringBoot.SpringBootHostBuilderExtensions.AddSpringBootConfiguration` | Extension method | Steeltoe.Extensions.Configuration.SpringBoot [Base/Core] | Removed | `builder.Configuration.AddSpringBootFromCommandLine/EnvironmentVariable()` | Redundant | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1360 @@ -496,6 +502,8 @@ For more information, see the updated [Configuration documentation](../configura ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Connector.AbstractServiceConnectorOptions` | Type | Steeltoe.Connector.Connector [Base/Core] | Removed | None | Redundant after refactorings | @@ -608,6 +616,8 @@ For more information, see the updated [Configuration documentation](../configura | `Steeltoe.Connector.SqlServer.EFCore.SqlServerDbContextOptionsExtensions.UseSqlServer` | Extension method | Steeltoe.Connector.EFCore | Moved | `SqlServerDbContextOptionsBuilderExtensions.UseSqlServer` | Takes an `IServiceProvider`, requires call to `builder.AddSqlServer()` first | | `Steeltoe.Connector.SqlServer.EFCore.SqlServerDbContextOptionsExtensions.UseSqlServer` | Extension method | Steeltoe.Connector.EFCore | Removed | | Redundant | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1528 @@ -669,6 +679,8 @@ For more information, see the updated [Connectors documentation](../configuratio ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Discovery.Client.ConfigurationUrlHelpers` | Type | Steeltoe.Discovery.Client [Base/Core] | Removed | None | Similar logic moved to internal `ConfigurationExtensions.GetListenAddresses` | @@ -877,6 +889,8 @@ For more information, see the updated [Connectors documentation](../configuratio | `Steeltoe.Discovery.Eureka.Transport.IEurekaHttpClient` | Type | Steeltoe.Discovery.Eureka | Removed | `Steeltoe.Discovery.Eureka.EurekaClient` | | | `Steeltoe.Discovery.Eureka.Util.DateTimeConversions` | Type | Steeltoe.Discovery.Eureka | Removed | None | Made internal | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1372 @@ -924,6 +938,8 @@ For more information, see the updated [Discovery documentation](../discovery/ind ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Extensions.Logging.DynamicLoggerConfiguration` | Type | Steeltoe.Extensions.Logging.Abstractions | Renamed | `Steeltoe.Logging.DynamicLoggerState` | Represents logger state, is unrelated to `IConfiguration` | @@ -966,6 +982,8 @@ For more information, see the updated [Discovery documentation](../discovery/ind | `Steeltoe.Extensions.Logging.DynamicSerilog.SerilogWebHostBuilderExtensions.UseSerilogDynamicConsole` | Extension method | Steeltoe.Extensions.Logging.DynamicSerilog [Base/Core] | Removed | `ILoggingBuilder.AddDynamicSerilog()` | | | `Steeltoe.Logging.DynamicSerilog.SerilogMessageProcessingLogger` | Type | Steeltoe.Logging.DynamicSerilog | Added | | Preserve structured logs with `IDynamicMessageProcessor` in Serilog | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1468 @@ -1024,6 +1042,8 @@ For more information, see the updated [Logging documentation](../logging/index.m ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Microsoft.Diagnostics.Runtime.Interop.IMAGE_FILE_MACHINE` | Type | Steeltoe.Management.Diagnostics | Removed | None | | @@ -1362,6 +1382,8 @@ For more information, see the updated [Logging documentation](../logging/index.m | `Steeltoe.Management.Tracing.TracingOptions` | Type | Steeltoe.Management.Tracing [Base/Core] | Removed | Use OpenTelemetry packages directly | | | `Steeltoe.Management.Tracing.TracingServiceCollectionExtensions.AddTracingLogProcessor` | Extension method | Steeltoe.Management.Tracing | Added | | Add trace info from `Activity.Current` to logs | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1521 @@ -1446,6 +1468,8 @@ For more information, see the updated [Management documentation](../management/i ### API changes +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Security.Authentication.CloudFoundry.ApplicationBuilderExtensions.UseCloudFoundryCertificateAuth` | Extension method | Steeltoe.Security.Authentication.CloudFoundry [Base/Core] | Removed | `app.UseCertificateAuthorization()` | | @@ -1500,12 +1524,16 @@ For more information, see the updated [Management documentation](../management/i | `Steeltoe.Security.DataProtection.Redis.RedisDataProtectionBuilderExtensions.PersistKeysToRedis` | Extension method | Steeltoe.Security.DataProtection.Redis | Added | | Takes an optional service binding name | | `Steeltoe.Security.DataProtection.RedisDataProtectionBuilderExtensions.PersistKeysToRedis` | Extension method | Steeltoe.Security.DataProtection.RedisCore | Moved | `PersistKeysToRedis()` in Steeltoe.Security.DataProtection.Redis package | | +
+ ### Breaking API changes after the 4.0 release The table above reflects the API surface as of the initial Steeltoe 4.0 release. The following breaking changes were introduced in later 4.x releases. #### Steeltoe.Security changes in 4.3 +
+ | Source | Kind | Package | Change | Replacement | Notes | | --- | --- | --- | --- | --- | --- | | `Steeltoe.Security.Authorization.Certificate.CertificateAuthorizationBuilderExtensions.AddOrgAndSpacePolicies` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddOrgAndSpacePoliciesForMutualTls()` | Header-based certificate forwarding can be spoofed by any client | @@ -1515,6 +1543,8 @@ The table above reflects the API surface as of the initial Steeltoe 4.0 release. | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificate` | Extension method | Steeltoe.Security.Authorization.Certificate | Obsolete | `AddClientCertificateForMutualTls(string)` | Header-based certificate injection can be spoofed by any client | | `Steeltoe.Security.Authorization.Certificate.CertificateHttpClientBuilderExtensions.AddClientCertificateForMutualTls` | Extension method | Steeltoe.Security.Authorization.Certificate | Added | | Send custom certificate with outgoing HTTP requests using mTLS | +
+ ### Notable PRs - https://github.com/SteeltoeOSS/Steeltoe/pull/1525