bcquality/microsoft/knowledge
wenjiefan 5016962b40 Align the IsHandled article slug, keywords and good sample with its narrowed scope
The article was rewritten to say a reset is required only when the value can
carry over, and its H1 was updated to match, but three artefacts still carried
the old "always initialize to false" premise:

- The slug still read `initialize-ishandled-to-false-before-publishing`, which
  contradicts the body. The slug is not cosmetic: Build-KnowledgeIndex.ps1
  ranks candidates on keywords, frontmatter dimensions, domain, path and title,
  so a stale path pushes selection back toward the behaviour this change
  narrows. Renamed to `reset-ishandled-only-when-the-value-can-carry-over`,
  following the existing precedent for conditional slugs such as
  `unreleased-symbol-change-is-not-a-breaking-change`.
- Keywords still listed `initialization` and `deterministic` and omitted
  `false-positive`, the tag this repository uses for suppression articles.
  Replaced with `carry-over` and `loop-iteration` and added `false-positive`.
- The good sample demonstrated only the "prefer separate fresh locals" clause
  and contained no reset at all, so the article's headline case had no positive
  example. It was also asymmetric with the bad sample, which gained a loop
  procedure showing a local that carries `true` into the next iteration.

Added the matching loop procedure to the good sample: a local declared outside
the loop is reset at the top of each iteration. That case cannot be solved by
introducing another local, because AL has no block scope, so it is the only
shape that demonstrates the reset the article still requires. It also gives the
engine the correct `suggested-code` shape for the loop finding; without it the
one-click fix adapted from the good sample would propose splitting the variable
rather than adding one line.

Also renamed the sample codeunits from "IsHandled Init ..." to
"IsHandled Carry Over ...", and updated the two references to the old slug:
the events leaf skill cue and the events pin in evaluation/review-fixtures.json.

validate_frontmatter.py reports 0 errors; Test-ReviewFixtures.ps1 passes with
32 cases across 16 leaf domains and resolves the events fixture to the renamed
article.
2026-09-02 11:08:16 +02:00
..
appsource Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
breaking-changes Add FP guards for field relocation to tableextension and event parameter addition 2026-08-04 10:41:03 +02:00
data-modeling Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
error-handling knowledge: add 3 FP-suppression guards from BC apps negative feedback 2026-07-21 09:45:09 +02:00
events Align the IsHandled article slug, keywords and good sample with its narrowed scope 2026-09-02 11:08:16 +02:00
interfaces Add P0 event and interface compatibility knowledge (#98) 2026-07-14 12:51:59 +02:00
performance Address review guidance feedback 2026-08-18 14:09:11 +02:00
privacy Scope tableextension requirement to Normal fields lacking a classification 2026-08-17 15:25:14 +02:00
query Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
security Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
style Refine self-improvement review guidance 2026-08-18 11:17:14 +02:00
telemetry Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
testing Address review guidance feedback 2026-08-18 14:09:11 +02:00
ui Add batch-2 FP guards: sentence-case action captions + primary-key Get is transaction-cached 2026-07-21 11:08:04 +02:00
upgrade knowledge: add 3 FP-suppression guards from BC apps negative feedback 2026-07-21 09:45:09 +02:00
web-services Add P0 integration and control add-in runtime guidance (#100) 2026-07-14 12:53:26 +02:00
.gitkeep Add .gitkeep files to community and microsoft directories; remove .gitkeep from samples 2026-04-17 06:03:14 +02:00