feat(blazorui): add built-in cache busting feature to BlazorUI #11307 (#11309)

Author: msynk

src/BlazorUI/Bit.BlazorUI/Info.cs

@@ -0,0 +1,12 @@
+namespace Bit.BlazorUI;
+
+/// <summary>
+/// Provides information about the bit BlazorUI library.
+/// </summary>
+public static class Info
+{
+    /// <summary>
+    /// The current version string of bit BlazorUI.
+    /// </summary>
+    public static string Version { get; } = "9.11.4-pre-01";
+}

src/BlazorUI/Demo/Client/Bit.BlazorUI.Demo.Client.Core/Pages/GettingStartedPage.razor

@@ -72,16 +72,17 @@
 
     <section class="page-section">
         <BitText Typography="BitTypography.H4" Class="subtitle">2. Namespace</BitText>
-        <div class="section-desc">Open the <BitTag Color="BitColor.TertiaryBackground">_Imports.razor</BitTag> 
-            file of your Blazor application and add this line:</div>
+        <BitText Typography="BitTypography.Body1">
+            Open the <BitTag Color="BitColor.TertiaryBackground">_Imports.razor</BitTag> file of your Blazor application and add this line:
+        </BitText>
         <CodeBox>&#64;using Bit.BlazorUI</CodeBox>
     </section>
 
     <section class="page-section">
         <BitText Typography="BitTypography.H4" Class="subtitle">3. Styles and Scripts</BitText>
 
         <BitText Typography="BitTypography.Body1">
-            Open <BitTag Color="BitColor.TertiaryBackground">App.razor</BitTag> or 
+            Open <BitTag Color="BitColor.TertiaryBackground">App.razor</BitTag> or
             <BitTag Color="BitColor.TertiaryBackground">index.html</BitTag> file and add the CSS file reference:
         </BitText>
         <CodeBox>&lt;link href="_content/Bit.BlazorUI/styles/bit.blazorui.css" rel="stylesheet" /></CodeBox>
@@ -117,5 +118,23 @@
         </BitAccordion>
     </section>
 
+    <section class="page-section">
+        <BitText Typography="BitTypography.H4" Class="subtitle">4. Cache busting</BitText>
+        <BitText Typography="BitTypography.Body1" Gutter>
+            You need to make sure you've implemented a proper <b>cache busting strategy</b> for all resources mentioned above.
+            Otherwise users will encounter issues related to cached versions of resources after you update the bit BlazorUI in your project.
+            <br /><br />
+            On .NET 9 or later you can simply use the new <BitTag Color="BitColor.TertiaryBackground">@@Assets[""]</BitTag> feature to
+            fingerprint the resource files automatically.
+            <br /><br />
+            Also, bit BlazorUI has a built-in feature in order to resolve the cache issues easily. using this feature you can simply add
+            a version query string to the url of the above resources like this:
+            <CodeBox>&lt;script src="_content/Bit.BlazorUI/scripts/bit.blazorui.js?v=@@Bit.BlazorUI.Info.Version">&lt;/script></CodeBox>
+            <b>Note</b>: You can only use this feature in the <BitTag Color="BitColor.TertiaryBackground">App.razor</BitTag> file, 
+            for other root files (like index.html in a WASM standalone project) you have to apply another solution, 
+            for example manually adding the version query string to the resrouce URLs.
+        </BitText>
+    </section>
+
     <FeedbackSection Url="GettingStartedPage.razor" />
 </div>