Skip to content

Bring the package READMEs and an XML doc in line with the code - #444

Merged
jeff377 merged 2 commits into
mainfrom
claude/p3-readmes
Nov 12, 2026
Merged

jeff377 merged 2 commits into
mainfrom
claude/p3-readmes

Conversation

@jeff377

@jeff377 jeff377 commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Part of #441

Package READMEs (en and zh-TW together), one XML doc and one package description. Each statement was checked against the code; an adversarial review then compared every changed sentence with the source, and its findings are fixed in the second commit.

  • Hosting: the db commands point to the DatabaseSettings guide and dotnet run -- db (which lists them all) instead of naming three; the directory list gains ApiKeys/ and BackendDefaultTypes.cs.
  • Core: no Attributes/ folder; Core and Definition share the Foundation layer name the dependency map uses.
  • UI.Core: the Blazor shared layer (Polhem.Web.Blazor), not the Server host, uses it; ListFilterState, CardListState, LiveComputationDegradation, RelationOpenRules and FieldValueChangeCoordinator are listed (the Mud README already sends readers there).
  • Api.Contracts / Api.Client / Api.Core: the field value change contract, FieldValueChangeAsync and its messages.
  • Api.Server: ApiCallContext is the access token, whether the call is local, and the payload format.
  • Blazor: the Server host references Polhem.Web.Blazor and the ASP.NET Core shared framework; the rule that keeps UIServices and Polhem.UI.ApiBridge out of the Blazor packages now lives in the Polhem.Web.Blazor README and says which assemblies UIServicesUsageGateTests scans (not the WebAssembly host, whose UIServices use nothing checks). Fluent: only the column filter button is a text symbol.
  • Root README: a Polhem.Templates row, the Cli row points to the Cli README for its commands, DefineEditor runs as dotnet polhem-define, Polhem.Expressions serves the Blazor live preview too.
  • DemoCenter: a duplicated row removed; the property grid subjects listed in full.
  • Northwind: the project tree gains the Fluent heads, Shared/ and the Dockerfile; the seeder writes demo-ro too; and a notice that the demo's master key is public, so a deployment built from the demo sets its own POLHEM_MASTER_KEY (ADR-015).
  • XML doc: GetDepartmentTreeResponse follows the per-request body codec (ADR-044). Package description: Polhem.UI.ApiBridge is for single-user front ends.

Verified locally: the documentation checks, and a Release build of Polhem.Api.Core. Lite CI.

Hosting: the db commands point to the guide and the directory list gains ApiKeys/ and BackendDefaultTypes.cs. Core: no Attributes/ folder. UI.Core: the Blazor shared layer, not the Server host, uses it, and the shared list, filter, relation, value-change and degradation types are listed. Api.Contracts/Client/Core: the field value change call. Api.Server: ApiCallContext's members. Fluent: only the filter button is a text symbol. Blazor.Server: it references Polhem.Web.Blazor, which now states the UIServices rule. Definition: one layer name. Root README: Polhem.Templates, the Cli commands, dotnet polhem-define, and the Blazor live preview. DemoCenter and Northwind READMEs: duplicate row, property grid subjects, project tree, demo-ro, and the public demo master key. GetDepartmentTreeResponse: the per-request body codec.
…cope, and a few descriptions

The Core README no longer lists Attributes/ (missed by the previous commit). The Web.Blazor README says which assemblies UIServicesUsageGateTests scans and that nothing checks the WebAssembly host's use of UIServices. UI.Core: the Blazor packages use everything but UIServices. Northwind: BlazorFluent is mounted by the Blazor head; the server also serves the WebAssembly heads. Fluent: only the grid's toolbar is icons. DemoCenter: the nested collections subject. Core and Definition share the Foundation layer name.
@jeff377
jeff377 enabled auto-merge (squash) November 12, 2026 12:49
@jeff377
jeff377 merged commit c554ef9 into main Nov 12, 2026
3 checks passed
@jeff377
jeff377 deleted the claude/p3-readmes branch November 12, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant