fix(docs): page help buttons open the right topic + wiring guard
The Federation and Runs help buttons opened the architecture doc:
federation.md/runs.md existed as assets but had no _DocEntry, so
showFaiDoc resolved the unknown slug to _kDocs.first. Register both
(onWelcome: false, so they don't clutter the newcomer grid but are
reachable), split the Welcome grid onto the curated subset, and make
the unknown-slug fallback assert in debug instead of silently opening
the wrong topic.
Guard (no-bugfix-without-a-guard): doc_help_wiring_test.dart scans
lib/ for every showFaiDoc('slug') call and asserts each has a
registered entry AND both assets/docs/<slug>[_de].md files. Exposes
kKnownDocSlugs for the test.
Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
This commit is contained in:
flemming-it
parent
588f437395
commit
5a3f00bb2c
7 changed files with 226 additions and 6 deletions
|
|
@ -50,6 +50,10 @@
|
|||
"welcomeDocFlowsBlurb": "YAML-Grundlagen, Templating-Referenz, das Extract→Summarize-Beispiel.",
|
||||
"welcomeDocApprovalsTitle": "Freigaben",
|
||||
"welcomeDocApprovalsBlurb": "Human-in-the-Loop-Checkpoints — wann nutzen, wie das Audit-Log sie protokolliert.",
|
||||
"welcomeDocFederationTitle": "Föderation",
|
||||
"welcomeDocFederationBlurb": "Weitere Hubs (Satelliten) anbinden, damit ihre Fähigkeiten hier nutzbar werden — was ein Satellit ist und wie die Anbindung abläuft.",
|
||||
"welcomeDocRunsTitle": "Hintergrund-Läufe",
|
||||
"welcomeDocRunsBlurb": "Flows, die im Hintergrund weiterlaufen — wozu, wie man die Funktion einschaltet und die Läufe überwacht.",
|
||||
"helpTooltip": "Hilfe",
|
||||
"errApprovalRejected": "Freigabe vom Reviewer abgelehnt.",
|
||||
"errApprovalRejectedHint": "Der Reviewer hat den Step abgelehnt. Begründung steht im Audit-Log.",
|
||||
|
|
@ -104,6 +108,7 @@
|
|||
"sidebarSettingsTooltip": "Einstellungen (⌘;)",
|
||||
"sidebarChannelTooltip": "Aktiver Kanal — klicken zum Wechseln.\nproduction = stabil · beta = Vorabversion · dev = laufend · local = Arbeitsumgebung",
|
||||
"buttonCancel": "Abbrechen",
|
||||
"buttonLearnMore": "Mehr erfahren",
|
||||
"buttonSave": "Speichern",
|
||||
"buttonClose": "Schließen",
|
||||
"buttonRetry": "Erneut versuchen",
|
||||
|
|
@ -1764,6 +1769,8 @@
|
|||
"federationCapabilities": "{count} angebotene Fähigkeiten",
|
||||
"federationAddDialogTitle": "Registrierungs-Token ausstellen",
|
||||
"federationNameLabel": "Satelliten-Name",
|
||||
"federationAddIntro": "Ein Satellit ist ein weiterer Hub, den dieser Hub anbindet — dessen Fähigkeiten werden dann hier in Flows nutzbar. Sie vergeben einen Namen und erhalten ein einmaliges Token, mit dem sich der Satellit bei diesem Hub anmeldet.",
|
||||
"federationNameHelp": "Frei wählbarer Name, um diesen Satelliten in der Liste wiederzuerkennen (z. B. Standort oder Zweck). Rein zur Anzeige — ändert nichts an der Technik.",
|
||||
"federationIssueButton": "Ausstellen",
|
||||
"federationIssueFailed": "Token konnte nicht ausgestellt werden: {error}",
|
||||
"federationEnrollmentTitle": "{name} einrichten",
|
||||
|
|
|
|||
|
|
@ -58,6 +58,10 @@
|
|||
"welcomeDocFlowsBlurb": "YAML basics, templating reference, the extract→summarize example.",
|
||||
"welcomeDocApprovalsTitle": "Approvals",
|
||||
"welcomeDocApprovalsBlurb": "Human-in-the-loop checkpoints — when to use them, how the audit log records them.",
|
||||
"welcomeDocFederationTitle": "Federation",
|
||||
"welcomeDocFederationBlurb": "Connect other hubs (satellites) so their capabilities become usable here — what a satellite is and how enrolment works.",
|
||||
"welcomeDocRunsTitle": "Background runs",
|
||||
"welcomeDocRunsBlurb": "Flows that keep working in the background — what they are for, how to switch the feature on and monitor the runs.",
|
||||
"helpTooltip": "Help",
|
||||
"errApprovalRejected": "Approval rejected by reviewer.",
|
||||
"errApprovalRejectedHint": "The reviewer marked this step as rejected. Check the audit log for the reviewer's reason.",
|
||||
|
|
@ -112,6 +116,7 @@
|
|||
"sidebarSettingsTooltip": "Settings (⌘;)",
|
||||
"sidebarChannelTooltip": "Active channel — click to switch.\nproduction = stable · beta = pre-release · dev = rolling · local = workspace",
|
||||
"buttonCancel": "Cancel",
|
||||
"buttonLearnMore": "Learn more",
|
||||
"buttonSave": "Save",
|
||||
"buttonClose": "Close",
|
||||
"buttonRetry": "Retry",
|
||||
|
|
@ -1793,6 +1798,8 @@
|
|||
},
|
||||
"federationAddDialogTitle": "Issue an enrollment token",
|
||||
"federationNameLabel": "Satellite name",
|
||||
"federationAddIntro": "A satellite is another hub this hub connects to — its capabilities then become usable here in flows. You give it a name and receive a one-time token the satellite uses to enrol with this hub.",
|
||||
"federationNameHelp": "A free-form name to recognize this satellite in the list (e.g. its location or purpose). Display only — it changes nothing technical.",
|
||||
"federationIssueButton": "Issue",
|
||||
"federationIssueFailed": "Could not issue token: {error}",
|
||||
"@federationIssueFailed": {
|
||||
|
|
|
|||
|
|
@ -398,6 +398,30 @@ abstract class AppLocalizations {
|
|||
/// **'Human-in-the-loop checkpoints — when to use them, how the audit log records them.'**
|
||||
String get welcomeDocApprovalsBlurb;
|
||||
|
||||
/// No description provided for @welcomeDocFederationTitle.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Federation'**
|
||||
String get welcomeDocFederationTitle;
|
||||
|
||||
/// No description provided for @welcomeDocFederationBlurb.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Connect other hubs (satellites) so their capabilities become usable here — what a satellite is and how enrolment works.'**
|
||||
String get welcomeDocFederationBlurb;
|
||||
|
||||
/// No description provided for @welcomeDocRunsTitle.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Background runs'**
|
||||
String get welcomeDocRunsTitle;
|
||||
|
||||
/// No description provided for @welcomeDocRunsBlurb.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Flows that keep working in the background — what they are for, how to switch the feature on and monitor the runs.'**
|
||||
String get welcomeDocRunsBlurb;
|
||||
|
||||
/// No description provided for @helpTooltip.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
@ -680,6 +704,12 @@ abstract class AppLocalizations {
|
|||
/// **'Cancel'**
|
||||
String get buttonCancel;
|
||||
|
||||
/// No description provided for @buttonLearnMore.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Learn more'**
|
||||
String get buttonLearnMore;
|
||||
|
||||
/// No description provided for @buttonSave.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
@ -5347,6 +5377,18 @@ abstract class AppLocalizations {
|
|||
/// **'Satellite name'**
|
||||
String get federationNameLabel;
|
||||
|
||||
/// No description provided for @federationAddIntro.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'A satellite is another hub this hub connects to — its capabilities then become usable here in flows. You give it a name and receive a one-time token the satellite uses to enrol with this hub.'**
|
||||
String get federationAddIntro;
|
||||
|
||||
/// No description provided for @federationNameHelp.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'A free-form name to recognize this satellite in the list (e.g. its location or purpose). Display only — it changes nothing technical.'**
|
||||
String get federationNameHelp;
|
||||
|
||||
/// No description provided for @federationIssueButton.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
|
|||
|
|
@ -180,6 +180,20 @@ class AppLocalizationsDe extends AppLocalizations {
|
|||
String get welcomeDocApprovalsBlurb =>
|
||||
'Human-in-the-Loop-Checkpoints — wann nutzen, wie das Audit-Log sie protokolliert.';
|
||||
|
||||
@override
|
||||
String get welcomeDocFederationTitle => 'Föderation';
|
||||
|
||||
@override
|
||||
String get welcomeDocFederationBlurb =>
|
||||
'Weitere Hubs (Satelliten) anbinden, damit ihre Fähigkeiten hier nutzbar werden — was ein Satellit ist und wie die Anbindung abläuft.';
|
||||
|
||||
@override
|
||||
String get welcomeDocRunsTitle => 'Hintergrund-Läufe';
|
||||
|
||||
@override
|
||||
String get welcomeDocRunsBlurb =>
|
||||
'Flows, die im Hintergrund weiterlaufen — wozu, wie man die Funktion einschaltet und die Läufe überwacht.';
|
||||
|
||||
@override
|
||||
String get helpTooltip => 'Hilfe';
|
||||
|
||||
|
|
@ -338,6 +352,9 @@ class AppLocalizationsDe extends AppLocalizations {
|
|||
@override
|
||||
String get buttonCancel => 'Abbrechen';
|
||||
|
||||
@override
|
||||
String get buttonLearnMore => 'Mehr erfahren';
|
||||
|
||||
@override
|
||||
String get buttonSave => 'Speichern';
|
||||
|
||||
|
|
@ -3164,6 +3181,14 @@ class AppLocalizationsDe extends AppLocalizations {
|
|||
@override
|
||||
String get federationNameLabel => 'Satelliten-Name';
|
||||
|
||||
@override
|
||||
String get federationAddIntro =>
|
||||
'Ein Satellit ist ein weiterer Hub, den dieser Hub anbindet — dessen Fähigkeiten werden dann hier in Flows nutzbar. Sie vergeben einen Namen und erhalten ein einmaliges Token, mit dem sich der Satellit bei diesem Hub anmeldet.';
|
||||
|
||||
@override
|
||||
String get federationNameHelp =>
|
||||
'Frei wählbarer Name, um diesen Satelliten in der Liste wiederzuerkennen (z. B. Standort oder Zweck). Rein zur Anzeige — ändert nichts an der Technik.';
|
||||
|
||||
@override
|
||||
String get federationIssueButton => 'Ausstellen';
|
||||
|
||||
|
|
|
|||
|
|
@ -181,6 +181,20 @@ class AppLocalizationsEn extends AppLocalizations {
|
|||
String get welcomeDocApprovalsBlurb =>
|
||||
'Human-in-the-loop checkpoints — when to use them, how the audit log records them.';
|
||||
|
||||
@override
|
||||
String get welcomeDocFederationTitle => 'Federation';
|
||||
|
||||
@override
|
||||
String get welcomeDocFederationBlurb =>
|
||||
'Connect other hubs (satellites) so their capabilities become usable here — what a satellite is and how enrolment works.';
|
||||
|
||||
@override
|
||||
String get welcomeDocRunsTitle => 'Background runs';
|
||||
|
||||
@override
|
||||
String get welcomeDocRunsBlurb =>
|
||||
'Flows that keep working in the background — what they are for, how to switch the feature on and monitor the runs.';
|
||||
|
||||
@override
|
||||
String get helpTooltip => 'Help';
|
||||
|
||||
|
|
@ -338,6 +352,9 @@ class AppLocalizationsEn extends AppLocalizations {
|
|||
@override
|
||||
String get buttonCancel => 'Cancel';
|
||||
|
||||
@override
|
||||
String get buttonLearnMore => 'Learn more';
|
||||
|
||||
@override
|
||||
String get buttonSave => 'Save';
|
||||
|
||||
|
|
@ -3159,6 +3176,14 @@ class AppLocalizationsEn extends AppLocalizations {
|
|||
@override
|
||||
String get federationNameLabel => 'Satellite name';
|
||||
|
||||
@override
|
||||
String get federationAddIntro =>
|
||||
'A satellite is another hub this hub connects to — its capabilities then become usable here in flows. You give it a name and receive a one-time token the satellite uses to enrol with this hub.';
|
||||
|
||||
@override
|
||||
String get federationNameHelp =>
|
||||
'A free-form name to recognize this satellite in the list (e.g. its location or purpose). Display only — it changes nothing technical.';
|
||||
|
||||
@override
|
||||
String get federationIssueButton => 'Issue';
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue