Merge pull request #34 from tgiachi/docs/fixes

docs: zero docfx warnings, GitHub navbar icon, README title alignment

Author: tgiachi

docs/templates/squidstd/public/main.css

@@ -52,3 +52,8 @@ table > thead { background-color: rgba(75, 180, 189, 0.12); }
 
 /* Affix (right-hand "In this article") active marker. */
 .affix ul li.active > a { color: var(--sqd-brand); border-left-color: var(--sqd-brand); }
+
+/* Package READMEs use <h1 align="center"> for GitHub/NuGet; on the site keep typography consistent. */
+article h1[align] {
+  text-align: start;
+}

docs/templates/squidstd/public/main.js

@@ -0,0 +1,10 @@
+// SquidStd DocFX modern-template extensions.
+export default {
+  iconLinks: [
+    {
+      icon: 'github',
+      href: 'https://github.com/tgiachi/squid-std',
+      title: 'GitHub',
+    },
+  ],
+}

src/SquidStd.Services.Core/Extensions/RegisterDefaultServicesExtensions.cs

@@ -131,8 +131,8 @@ public IContainer RegisterEventBusService()
 
         /// <summary>
         /// Registers the recursive file watcher service as a singleton resolving the event bus.
-        /// Not part of <see cref="RegisterCoreServices()" />: opt in, then call
-        /// <see cref="Core.Interfaces.Files.IFileWatcherService.Watch(string)" /> for the directories to watch.
+        /// Not part of <c>RegisterCoreServices</c>: opt in, then call
+        /// <see cref="IFileWatcherService.Watch(string)" /> for the directories to watch.
         /// </summary>
         /// <param name="debounceDelay">Optional debounce window; defaults to 300ms when null.</param>
         /// <returns>The same container for chaining.</returns>

src/SquidStd.Tui/TuiView.cs

@@ -8,15 +8,15 @@ namespace SquidStd.Tui;
 /// <summary>
 /// Base class for views: a Terminal.Gui <see cref="Window" /> that owns a typed ViewModel and a
 /// <see cref="ViewBinder" />. Implement <see cref="BuildLayout" /> to create widgets and
-/// <see cref="Bind" /> to declare bindings; both run once during <see cref="Initialize" />.
+/// <see cref="Bind" /> to declare bindings; both run once during <see cref="ITuiView.Initialize" />.
 /// </summary>
 /// <typeparam name="TViewModel">The ViewModel type for this view.</typeparam>
 public abstract class TuiView<TViewModel> : Window, ITuiView
     where TViewModel : TuiViewModel
 {
     private readonly ViewBinder _binder;
 
-    /// <summary>The bound ViewModel. Set by the navigator before <see cref="Initialize" />.</summary>
+    /// <summary>The bound ViewModel. Set by the navigator before <see cref="ITuiView.Initialize" />.</summary>
     protected TViewModel ViewModel { get; private set; } = null!;
 
     protected TuiView()

src/SquidStd.Vfs.Database/README.md

@@ -47,8 +47,8 @@ The `VfsFileEntity` table is created automatically by FreeSql on first access (s
 ## Related
 
 - Tutorial: [Virtual filesystem](https://tgiachi.github.io/squid-std/tutorials/vfs.html)
-- [`SquidStd.Vfs`](../SquidStd.Vfs/README.md) - core backends and decorators
-- [`SquidStd.Database`](../SquidStd.Database/README.md) - required database module
+- [`SquidStd.Vfs`](https://tgiachi.github.io/squid-std/articles/vfs.html) - core backends and decorators
+- [`SquidStd.Database`](https://tgiachi.github.io/squid-std/articles/database.html) - required database module
 
 ## License
 

src/SquidStd.Vfs.S3/README.md

@@ -48,7 +48,7 @@ For native AWS with the default credential chain, omit `AccessKey`/`SecretKey` a
 ## Related
 
 - Tutorial: [Virtual filesystem](https://tgiachi.github.io/squid-std/tutorials/vfs.html)
-- [`SquidStd.Vfs`](../SquidStd.Vfs/README.md) - core backends and decorators
+- [`SquidStd.Vfs`](https://tgiachi.github.io/squid-std/articles/vfs.html) - core backends and decorators
 
 ## License