SteeltoeOSS · TimHess · Jul 30, 2025 · Jul 22, 2025 · Jul 22, 2025 · Jul 28, 2025
diff --git a/.gitignore b/.gitignore
@@ -414,3 +414,6 @@ src/Steeltoe.io/wwwroot/logo.svg
 src/Steeltoe.io/wwwroot/manifest.json
 src/Steeltoe.io/wwwroot/sitemap.xml
 src/Steeltoe.io/wwwroot/*xrefmap.yml
+
+# Overrides
+!docs/articles/releases
diff --git a/docs/articles/index.md b/docs/articles/index.md
@@ -10,6 +10,13 @@ uid: articles
 
 <!-- markdownlint-disable MD033 --> <!-- Allow HTML on this page -->
 <ul class="blog-list">
+    <li class="blog-item">
+        <a href="releases/steeltoe-4-0-0-rc1.md">
+            <span class="blog-date">July 29 2025</span>
+            <div class="blog-author">Tim Hess</div>
+            <div class="blog-title">Announcing Steeltoe 4.0.0 RC1: A Major Maintenance Release</div>
+        </a>
+    </li>
     <li class="blog-item">
         <a href="steeltoe-3-2-2-adds-kube-service-bindings.md">
             <span class="blog-date">January 10 2023</span>

diff --git a/docs/articles/releases/steeltoe-4-0-0-rc1.md b/docs/articles/releases/steeltoe-4-0-0-rc1.md
@@ -0,0 +1,113 @@
+---
+_disableContribution: true
+_hideTocVersionToggle: true
+
+description:
+date: 07/29/2025
+uid: steeltoe-4-0-0-rc1.html
+tags: ["new-release"]
+author.name: Tim Hess
+---
+
+# Steeltoe 4.0.0 RC1: A Major Maintenance Release
+
+Steeltoe 4.0.0 RC1 is now available — and it's production-ready.
+This release brings a modernized developer experience, compatibility with the latest .NET versions, improved performance and scalability, enhanced security and updated support for essential cloud platforms and third-party tools.
+Whether you're starting something new or modernizing an existing app, 4.0 is the best way to build cloud-native .NET applications today.
+
+## What's New Since 3.2?
+
+Steeltoe 4.0 introduces changes across nearly every area of the framework and surrounding projects and is built for .NET 8+
+
+For a deeper dive, check out the full changelog in the docs: [What's New in Steeltoe 4.0](https://steeltoe.io/docs/v4/welcome/whats-new.html)
+
+### Enhanced Developer Experience
+
+Steeltoe 4.0 brings modern .NET features and tooling improvements that make development faster and more productive:
+
+* Streamlined packages (`*Base` and `*Core` packages have been combined), now with debug symbols embedded
+* Async-first APIs
+* Nullable annotations
+* Embedded JSON schemas for IDE completion
+* Simplified and consistent extension methods for dependency injection and configuration
+* Updated developer container images for local development
+
+### Cleaner APIs, Fewer Surprises
+
+Steeltoe 4.0 delivers simpler APIs that align with modern .NET expectations, helping developers get started faster and reducing long-term friction.
+Over the years, Steeltoe accumulated a large set of APIs that solved similar problems in slightly different ways.
+Almost all of the APIs Steeltoe provided were public, with little to no guidance on when and how to extend Steeltoe.
+This made it harder for developers to discover the "right" approach — and it made maintenance difficult.
+
+With Steeltoe 4.0, we've taken a deliberate approach to address this:
+
+* **Reviewed the entire public API** to eliminate duplication, improve clarity and consistency and hide details that were not designed to be extensible.
+* **Aligned APIs more closely with Microsoft conventions**, reducing surprises for all developers.
+* **Added internal tooling** to detect breaking changes across releases and ensure future stability.
+
+Breaking changes are [documented](https://steeltoe.io/docs/v4/welcome/whats-new.html), and our [samples](https://github.com/SteeltoeOSS/Samples/tree/4.x) reflect the latest best practices.
+
+#### Steeltoe Entrypoint Changes
+
+The majority of Steeltoe's functionality can be added to an application via `IServiceCollection` and `IConfigurationBuilder` extension methods.
+In some cases, prior versions of Steeltoe also included various flavors of extension methods on host builders.
+These extension methods enabled adding Steeltoe components with a single line of code in `Program.cs` or `Startup.cs`.
+These days, however, `HostApplicationBuilder` and `WebApplicationBuilder` provide simple and direct access to the configuration builder and service collection, allowing all app configuration code in `Program.cs`, so the extra layer doesn't add the same value.
+
+For 4.0, we reviewed all extension methods to ensure that we don't unnecessarily offer multiple APIs to accomplish the same thing.
+In places where host builder extensions are definitely useful, we've ensured they're available for all currently applicable options and worked to enhance the XML comments so that it's easier for you to determine which option to use.
+
+### Dependency and Compatibility Updates
+
+All dependencies have been updated to remove known vulnerabilities and ensure compatibility with the latest versions.
+By upgrading to Steeltoe 4.0, you benefit from improved performance, resiliency and security across the stack.
+
+Furthermore, all of Steeltoe's integrations with external systems have been retested against the latest versions of major enterprise and open-source platforms, such as:
+
+* MongoDB, MySQL, PostgreSQL, Microsoft SQL Server
+* RabbitMQ
+* Redis and Valkey
+* Spring Cloud Config Server
+* Spring Cloud Netflix Eureka and HashiCorp Consul
+* Tanzu Platform (Cloud Foundry)
+* Spring Boot Admin
+* Prometheus and Grafana
+
+### Improved Documentation, Samples and Supporting Systems
+
+Steeltoe 4.0 comes with updated docs, modernized samples, and improved tooling to help you get started faster and with more confidence. That means:
+
+* Rewritten and reorganized samples that reflect modern .NET practices and highlight where Steeltoe fits in.
+* An updated [Steeltoe Initializr](https://start.steeltoe.io/) that supports Steeltoe 4.0.
+* Documentation improvements across all major areas.
+* Improved test coverage and continuous integration pipelines to support faster, more reliable releases — with fewer surprises for users.
+* Improved standards and automated tools for maintaining high levels of code quality.
+
+### What's Gone
+
+We've also used this release as an opportunity to simplify the project by removing several components that did not see great adoption and were very complex.
+If you're looking for something that seems to have disappeared, check out the list of [dropped components](https://github.com/SteeltoeOSS/Steeltoe/issues/1244).
+
+These decisions weren't taken lightly — but we believe they'll help keep Steeltoe focused and easier to use.
+
+## Production-Ready and Supported
+
+Although this release is labeled a "release candidate", Steeltoe 4.0.0 RC1 reflects our intent for the final 4.0.0 release and is classified as a go-live release, allowing you to use it in production environments.
+It has passed our full suite of automated and manual tests, including cross-platform and integration scenarios.
+
+We do not expect further breaking changes before GA.
+
+## Try It Out — and Help Shape 4.0
+
+Steeltoe 4.0.0 RC1 is available on NuGet now.
+This is the perfect time to give it a try on a new app or upgrade your existing apps.
+[Open an issue](https://github.com/SteeltoeOSS/Steeltoe/issues) if you hit a snag.
+
+We're planning to release the general availability version later this summer. No RC2 is currently planned — so your feedback now is especially valuable.
+
+* 📚 Browse the updated [samples](https://github.com/SteeltoeOSS/Samples/tree/4.x)
+* 🔗 Ask questions and join the conversation on [Slack](https://slack.steeltoe.io/)
+* 📢 Reach us on [Twitter/X](https://x.com/SteeltoeOSS) and [Bluesky](https://bsky.app/profile/steeltoe.io)
+
+Thanks to everyone in the community who has tested pre-releases, filed issues, and contributed code, docs, and encouragement.
+We're excited to share this release with you — and eagerly await your feedback.
diff --git a/docs/articles/toc.yml b/docs/articles/toc.yml
@@ -1,4 +1,5 @@
 - href: index.md
+- href: releases/steeltoe-4-0-0-rc1.md
 - href: steeltoe-3-2-2-adds-kube-service-bindings.md
 - href: releases/steeltoe-3-2-whats-new.md
 - href: whats-new-in-steeltoe-31.md

diff --git a/src/Steeltoe.io/Components/Pages/Home.razor b/src/Steeltoe.io/Components/Pages/Home.razor
@@ -115,7 +115,7 @@
                         <div class="title">@((MarkupString)calendarEvent.Title)</div>
                         <div class="desc">@((MarkupString)calendarEvent.Description)</div>
                         <div class="">
-                            <a class="special-link" href="@calendarEvent.Url" target="_blank">read more &gt;</a>
+                            <a class="special-link" href="@calendarEvent.Url">read more &gt;</a>
                         </div>
                     </div>
                 </div>

diff --git a/src/Steeltoe.io/appsettings.json b/src/Steeltoe.io/appsettings.json
@@ -9,35 +9,35 @@
   "AllowedHosts": "*",
   "CalendarEvents": {
     "Events": [
+      {
+        "date": "<span>July</span> 29 2025",
+        "title": "Steeltoe 4.0.0 RC1: A Major Maintenance Release",
+        "description": "Version 4.0.0 is a product of top to bottom API and code review, with significant consistency, documentation and quality enhancements.",
+        "url": "/articles/releases/steeltoe-4-0-0-rc1.html"
+      },
+      {
+        "date": "<span>January</span> 10 2023",
+        "title": "Announcing Steeltoe 3.2.2",
+        "description": "Steeltoe 3.2.2 adds experimental support for Kubernetes Service Bindings",
+        "url": "/articles/steeltoe-3-2-2-adds-kube-service-bindings.html"
+      },
       {
         "date": "<span>May</span> 27 2022",
         "title": "Steeltoe 3.2.0 is here!",
         "description": "Version 3.2.0 brings support for .NET 6.0 and more!",
-        "url": "https://docs.steeltoe.io/articles/releases/steeltoe-3-2-whats-new.html"
+        "url": "/articles/releases/steeltoe-3-2-whats-new.html"
       },
       {
         "date": "<span>July</span> 13 2021",
         "title": "Steeltoe 3.1.0 GA is here!",
         "description": "Version 3.1 brings some impressive new features including Steeltoe Stream, Steeltoe Messaging, Steeltoe Bootstrap, and support for Spring Cloud Data Flow.",
-        "url": "https://docs.steeltoe.io/articles/releases/steeltoe-3-1-minor-release-major-deal.html"
+        "url": "/articles/releases/steeltoe-3-1-minor-release-major-deal.html"
       },
       {
         "date": "<span>January</span> 14 2021",
         "title": "Create .NET Microservice Projects Automatically with Steeltoe Initializr",
         "description": "Get started using Initializr and get to production faster!",
-        "url": "https://docs.steeltoe.io/articles/create-dotnet-microservice-projects-automatically-with-steeltoe-initializr.html"
-      },
-      {
-        "date": "<span>October</span> 1 2020",
-        "title": "Use Kubernetes for Modern .NET Apps with Steeltoe and Tye",
-        "description": "Learn about new Kubernetes features included in Steeltoe 3.0 and use Tye to help develop for K8s.",
-        "url": "https://docs.steeltoe.io/articles/tech-tutorial-use-kubernetes-for-modern-net-apps-steeltoe-and-project-tye-are-your-path-to-productivity.html"
-      },
-      {
-        "date": "<span>August</span> 24 2020",
-        "title": "Steeltoe 3.0 is officially available",
-        "description": "Version 3.0 is packed with messaging, kubernetes support, new ways to implement endpoints, and so much more.",
-        "url": "https://docs.steeltoe.io/articles/releases/steeltoe-3-0-packs-a-mighty-punch-with-many-new-features.html"
+        "url": "/articles/create-dotnet-microservice-projects-automatically-with-steeltoe-initializr.html"
       }
     ]
   },

diff --git a/src/Steeltoe.io/wwwroot/css/site.css b/src/Steeltoe.io/wwwroot/css/site.css
@@ -428,7 +428,11 @@ app {
     margin: 3% 0 3% 0;
     min-height: 90px;
 }
-
+.news {
+    border-top: 1px dotted steelblue;
+    margin-bottom: 5px;
+    padding-bottom: 5px;
+}
 .news .date {
     font-size: 75%;
     text-transform: uppercase;