SteeltoeOSS · TimHess · Mar 10, 2025 · Mar 10, 2025 · Mar 10, 2025 · Mar 11, 2025
diff --git a/.editorconfig b/.editorconfig
@@ -5,3 +5,6 @@ indent_style = space
 trim_trailing_whitespace = true
 insert_final_newline = true
 charset = utf-8
+
+[.ps1]
+end_of_line = lf
diff --git a/.github/workflows/build-and-stage.yml b/.github/workflows/build-and-stage.yml
@@ -34,6 +34,10 @@ jobs:
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
+    - name: Generate API browser docs
+      shell: pwsh
+      run: src/api-browser-generation/build-metadata.ps1
+
     - name: dotnet build
       run: dotnet build src/Client --configuration Release
 

diff --git a/.gitignore b/.gitignore
@@ -6,7 +6,6 @@
 *.code-workspace
 
 src/.vscode/*
-src/Client/wwwroot/site-data/docs/*
 
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
@@ -364,7 +363,6 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
-src/Client/wwwroot/site-data/docs/toc.json
 
 # local tools
 tools/
@@ -374,3 +372,18 @@ tools/
 
 # Visual Studio Code state
 /.vscode/
+
+# Items produced or moved by docfx
+src/Client/wwwroot/docs
+src/Client/wwwroot/api/
+src/Client/wwwroot/public/
+src/Client/wwwroot/manifest.json
+src/Client/wwwroot/guides/
+src/Client/wwwroot/articles/
+src/Client/wwwroot/*xrefmap.yml
+src/Client/wwwroot/index.json
+src/Client/docfx-content/api-browser/**/.manifest
+src/Client/docfx-content/api-browser/**/*.yml
+
+src/api-browser-generation/sources/
+src/api-browser-generation/yaml/
diff --git a/Dockerfile b/Dockerfile
diff --git a/docker-compose.yaml b/docker-compose.yaml
diff --git a/src/.gitignore b/src/.gitignore
diff --git a/src/Client/Components/App.razor b/src/Client/Components/App.razor
@@ -34,10 +34,12 @@
     <base href="/">
     <link rel="icon" href="/images/favicon.png" type="image/png">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" integrity="sha384-QWTKZyjpPEjISv5WaRU9OFeRpok6YctnYmDr5pNlyT2bRjXh0JMhjY6hW+ALEwIH" crossorigin="anonymous">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">
     <link rel="stylesheet" href="css/fonts.css">
     <link rel="stylesheet" href="css/site.css">
     <link rel="stylesheet" href="css/mobile.css">
-    <HeadOutlet/>
+    <script src="js/main.js"></script>
+    <HeadOutlet />
 </head>
 <body>
 <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MMDFJKF" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>

diff --git a/src/Client/Components/Href.razor b/src/Client/Components/Href.razor
@@ -1,5 +1,5 @@
-
-<NavLink class="@(Class + (AsButton ? " border border-dark font-weight-bold btn btn-default border-black p-3" : ""))"
+<NavLink
+    class="@(Class + (AsButton ? " btn btn-default p-3 border-dark" : ""))"
          target="@(NewWindow ? "_blank" : "")" role="@(AsButton ? "button" : "")" @attributes="AdditionalAttributes">@ChildContent</NavLink>
 
 @code

diff --git a/src/Client/Components/Layout/SiteFooter.razor b/src/Client/Components/Layout/SiteFooter.razor
@@ -1,4 +1,3 @@
-@inject IOptionsSnapshot<DocsSiteOptions> DocsSiteOptions
 
 <footer>
     <div class="width-all bg-midnight-blue">
@@ -40,10 +39,10 @@
                 <div class="col" id="footer-learn-col">
                     <div class="pb-2 font-weight-bold">Learn</div>
                     <div><Href Class="link-light" href="/initializr" NewWindow="true">Steeltoe Initializr</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.GuidesHome)">Guides</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.DocsHome)">Documentation</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.ApiBrowserHome)">API Browser</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.BlogHome)">Blog</Href></div>
+                    <div><Href Class="link-light" href="/guides">Guides</Href></div>
+                    <div><Href Class="link-light" href="/api">Documentation</Href></div>
+                    <div><Href Class="link-light" href="/api/browser">API Browser</Href></div>
+                    <div><Href Class="link-light" href="/articles">Blog</Href></div>
                 </div>
                 <div class="col" id="footer-projects-col">
                     <div class="pb-2 font-weight-bold">Projects</div>
@@ -52,11 +51,11 @@
                     <div><Href Class="link-light" href="/logging">Dynamic Logging</Href></div>
                     <div><Href Class="link-light" href="/cloud-management">Management</Href></div>
                     <div><Href Class="link-light" href="/messaging">Messaging</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.FileShareHome)">Network File Sharing</Href></div>
+                    <div><Href Class="link-light" href="/api/v4/fileshares">Network File Sharing</Href></div>
                     <div><Href Class="link-light" href="/security-providers">Security</Href></div>
                     <div><Href Class="link-light" href="/service-connectors">Service Connectors</Href></div>
                     <div><Href Class="link-light" href="/service-discovery">Service Discovery</Href></div>
-                    <div><Href Class="link-light" href="@(DocsSiteOptions.Value.DocsStreamHome)">Stream</Href></div>
+                    <div><Href Class="link-light" href="/api/v3/stream">Stream</Href></div>
                 </div>
                 <div class="col" id="footer-others-col">
                     @*<div class="pb-2 font-weight-bold"><Href href="/training">Training</Href></div>*@
@@ -66,30 +65,22 @@
             </div>
             <div class="row py-sm-0 py-4">
                 <div class="col text-end">
-                    <Href href="https://github.com/SteeltoeOSS" title="Steeltoe on GitHub" NewWindow="true">
-                        <svg id="github-icon" width="100px" height="50px" viewBox="0 0 1 75" xmlns="http://www.w3.org/2000/svg">
-                            <defs>
-                                <style type="text/css">
-                                    #github-icon .cls-1 { fill: #ffffff; }
-                                    #github-icon .cls-2 { fill: #000000; fill-rule: evenodd; }
-                                </style>
-                            </defs>
-                            <path class="cls-1" d="M38,0a38,38,0,1,0,38,38A38,38,0,0,0,38,0Z"></path>
-                            <path class="cls-2" d="M38,15.59A22.95,22.95,0,0,0,30.71,60.3c1.15.21,1.57-.5,1.57-1.11s0-2,0-3.9c-6.38,1.39-7.73-3.07-7.73-3.07A6.09,6.09,0,0,0,22,48.86c-2.09-1.42.15-1.39.15-1.39a4.81,4.81,0,0,1,3.52,2.36c2,3.5,5.37,2.49,6.67,1.91a4.87,4.87,0,0,1,1.46-3.07c-5.09-.58-10.45-2.55-10.45-11.34a8.84,8.84,0,0,1,2.36-6.15,8.29,8.29,0,0,1,.23-6.07s1.92-.62,6.3,2.35a21.82,21.82,0,0,1,11.49,0c4.38-3,6.3-2.35,6.3-2.35a8.29,8.29,0,0,1,.23,6.07,8.84,8.84,0,0,1,2.36,6.15c0,8.81-5.37,10.75-10.48,11.32a5.46,5.46,0,0,1,1.56,4.25c0,3.07,0,5.54,0,6.29s.42,1.33,1.58,1.1A22.94,22.94,0,0,0,38,15.59Z"></path>
+                    <Href href="https://github.com/SteeltoeOSS" title="Steeltoe on GitHub" NewWindow="true" Class="link-light">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor"
+                            class="bi bi-github" viewBox="0 0 16 16">
+                            <path
+                                d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8">
+                            </path>
                         </svg>
                     </Href>
                 </div>
                 <div class="col">
-                    <Href href="https://twitter.com/steeltoeoss" title="Steeltoe on Twitter" NewWindow="true">
-                        <svg id="twitter-icon" width="100px" height="50px" viewBox="0 0 115 75" xmlns="http://www.w3.org/2000/svg">
-                            <defs>
-                                <style type="text/css">
-                                    #twitter-icon .cls-1 { fill: #ffffff; }
-                                    #twitter-icon .cls-2 { fill: #000000; }
-                                </style>
-                            </defs>
-                            <circle class="cls-1" cx="37.97" cy="37.97" r="37.97"></circle>
-                            <path class="cls-2" d="M55.2,22.73a15.43,15.43,0,0,1-4.88,1.91,7.56,7.56,0,0,0-5.61-2.49A7.78,7.78,0,0,0,37,30a7.56,7.56,0,0,0,.2,1.79,21.63,21.63,0,0,1-15.84-8.23,8,8,0,0,0,2.37,10.52,7.66,7.66,0,0,1-3.48-1v.09A7.84,7.84,0,0,0,26.45,41a7.54,7.54,0,0,1-2,.28A7.64,7.64,0,0,1,23,41.09a7.71,7.71,0,0,0,7.18,5.47,15.21,15.21,0,0,1-9.55,3.37,15.78,15.78,0,0,1-1.83-.11,21.41,21.41,0,0,0,11.78,3.54c14.13,0,21.86-12,21.86-22.42,0-.34,0-.68,0-1a15.67,15.67,0,0,0,3.83-4.08,14.9,14.9,0,0,1-4.41,1.24A7.8,7.8,0,0,0,55.2,22.73Z" data-name="Twitter" id="Twitter-2"></path>
+                    <Href href="https://x.com/steeltoeoss" title="Steeltoe on Twitter/X" NewWindow="true" Class="link-light">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor"
+                            class="bi bi-twitter-x" viewBox="0 0 16 16">
+                            <path
+                                d="M12.6.75h2.454l-5.36 6.142L16 15.25h-4.937l-3.867-5.07-4.425 5.07H.316l5.733-6.57L0 .75h5.063l3.495 4.633L12.601.75Zm-.86 13.028h1.36L4.323 2.145H2.865z">
+                            </path>
                         </svg>
                     </Href>
                 </div>