Namespace Kuestenlogik.Bowire.Help

BowireHelpRailContribution: Help rail contribution (#324). Hoists the in-app docs out of the unified right-side drawer into a full rail with the standard left-sidebar + main-pane shape every other rail uses.

HelpSearchHit: One result from Search(string, int). Carries an excerpt so the result list can show context without a follow-up topic-fetch per hit. The score is opaque to the workbench — only the order matters — but provider implementations may stabilise on 0..1 or 0..100 ranges as a future convention.

HelpTopic: A single help topic in its full form. The body ships in two shapes: the raw Markdown source (kept for back-compat + tools that want the original) and BodyHtml — sanitised HTML the provider produced so the workbench can innerHTML it without re-parsing markdown in the browser. The mini-renderer the drawer used to ship choked on embedded HTML (DocFX <dl>, <picture>, theme-aware SVG hero) and showed it as escaped text. Pipeline rendering on the server side keeps the UI thin and lets DocFX-shaped pages render correctly.

HelpTopicSummary: Lightweight projection of HelpTopic for list views. The body is omitted so a Topics call doesn't pull the whole markdown set into the browser when the user only wants to scan titles. The Summary rides along so the topic-tree nav can render a one-line excerpt under the short title.

IBowireHelpProvider: Contract for in-app documentation. The core ships no implementation; the separate Kuestenlogik.Bowire.Help NuGet package provides one over the embedded docs/ markdown set. Embedded ASP.NET hosts that don't need workbench docs simply don't reference that package and pay zero cost — the workbench renders Help affordances as disabled (see /api/help/available).

Sections