docs(di): trim cycle-internal codes and verbose block comments
Code comments were drifting into plan-internal shorthand (DI-2a, Slice B, "see plan §9") that nobody outside the cycle authors can decode. They also tended toward AI-generated paragraph blocks where a two-line WHY would have done. This commit tightens the comment surface from the v1.5.0 work: - IPluginLogProxy header lists the consumer buckets without naming the cycle items that decided them. - DalamudLogger / DalamudLoggingProvider provenance markers explain themselves in two lines each; the long EUPL-rationale paragraph moves to the commit message. - PluginHostFactory block headers shrink to one line each, ASCII dividers come out, plan-internal codes go. - Plugin.cs field doc and Phase-1 / DisposeAsync comments lose the cycle-name references; the file gains nothing from "C3 surfaced X" in code. - FontManager / GameFunctions static-method notes shrink to one sentence each. - InitHostedServices class header keeps the eager-resolve WHY in three lines, drops the constraint label. Csharpier reformatted the .csproj layout (long PackageReference multi-lined). No functional change, no behavior change.
This commit is contained in:
@@ -33,11 +33,8 @@ internal sealed class DalamudLogger : ILogger
|
||||
if (!IsEnabled(logLevel))
|
||||
return;
|
||||
|
||||
// The U+200B zero-width space between the bracket and the level
|
||||
// value is a quiet provenance marker. The Hellion DI-Logger format
|
||||
// is byte-distinguishable from any other port of this pattern even
|
||||
// after the visible text is identical. EUPL-1.2 reuse stays valid;
|
||||
// attribution traces stay possible.
|
||||
// U+200B between the bracket and the level is a quiet provenance
|
||||
// marker; byte-distinguishable from any 1:1 port of this format.
|
||||
if ((int)logLevel <= (int)LogLevel.Information)
|
||||
{
|
||||
_pluginLog.Information($"[{_name}]{{{(int)logLevel}}} {state}");
|
||||
|
||||
@@ -10,9 +10,7 @@ namespace HellionChat.Infrastructure.Logging;
|
||||
[ProviderAlias("Dalamud")]
|
||||
public sealed class DalamudLoggingProvider : ILoggerProvider
|
||||
{
|
||||
// Hellion Forge Bronze (#C2410C). Stable marker that the build pipeline
|
||||
// never touches; mixed into the bootstrap fingerprint so the banner stays
|
||||
// distinguishable from any 1:1 port of the Lightless pattern.
|
||||
// Hellion Forge Bronze (#C2410C). Mixed into the bootstrap fingerprint.
|
||||
private const string HellionMarker = "HellionForgeBronzeC2410C";
|
||||
|
||||
private readonly ConcurrentDictionary<string, DalamudLogger> _loggers = new(
|
||||
@@ -27,12 +25,8 @@ public sealed class DalamudLoggingProvider : ILoggerProvider
|
||||
EmitBootstrapBanner();
|
||||
}
|
||||
|
||||
// Runs once per plugin load (the provider is a container singleton). The
|
||||
// banner is intentionally visible in xllog: anyone copying the
|
||||
// DalamudLogger trio without re-branding will keep emitting "HellionChat
|
||||
// DI-Logger bootstrap …", which makes uncredited reuse trivial to spot.
|
||||
// EUPL-1.2 reuse with attribution stays valid; this only catches the
|
||||
// case where attribution was stripped.
|
||||
// One-shot per plugin load. Intentionally visible in xllog so uncredited
|
||||
// ports of the DalamudLogger trio keep announcing their origin.
|
||||
private void EmitBootstrapBanner()
|
||||
{
|
||||
var version =
|
||||
|
||||
Reference in New Issue
Block a user