a9f3c50863
The previous LLM-generated knowledge files contained factual
hallucinations. The most visible was the claim that `FindFirst` /
`FindLast` "forces a full-table scan" on an unfiltered record - it does
not; those APIs return a single row via the current key.
Other inaccuracies the audit found and fixed:
* `FindSet(true)` was described as "taking a LockTable". The correct
upstream phrasing is that `FindSet(true)` sets
`ReadIsolation::UpdLock` on the read. UpdLock and LockTable are
related but distinct mechanisms.
* The list of production-scale tables had been invented beyond the
upstream source (e.g. "Detailed Cust. Ledg. Entry") without a
citation. The regenerated list matches the ten tables upstream lists
with their P95 row counts.
* `SetLoadFields` guidance had been augmented with an extra mechanism
claim ("the database resolves the filter using the index without
hydrating the value") not present in upstream.
Approach: full regeneration of `microsoft/knowledge/` from the six
upstream BCApps Code Review instruction files, with Microsoft Learn /
the AL language reference as a secondary source. Every claim in every
regenerated file is anchored to a verbatim upstream quote (or a Learn
URL); the audit trail lives in artifacts/trace-<domain>.json on the
session workspace.
The PR #11 transaction/error-handling cluster is preserved verbatim:
* performance/understand-implicit-transaction-boundary.md
* performance/codeunit-run-as-atomic-sub-operation.{md,good.al,bad.al}
* performance/codeunit-run-requires-prior-commit-inside-transaction.{md,good.al,bad.al}
* performance/use-tryfunction-for-error-catching-not-rollback.{md,good.al,bad.al}
* performance/avoid-commit-inside-loops.{md,good.al,bad.al}
* security/commitbehavior-attribute-scopes-explicit-commits.{md,good.al,bad.al}
* testing/transactionmodel-attribute-governs-test-transactions.{md,good.al,bad.al}
These articles already cite Microsoft Learn and were carefully
cross-referenced; the regeneration skips their topics rather than
duplicating them.
File counts after regeneration:
performance 35 .md (5 preserved + 30 new)
privacy 17 .md
security 18 .md (1 preserved + 17 new)
style 33 .md
testing 1 .md (preserved)
ui 19 .md
upgrade 18 .md
Total 141 atomic knowledge files, each strictly one rule. All pass
.github/scripts/validate_frontmatter.py with 0 errors and 0 warnings.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1.9 KiB
| bc-version | domain | keywords | technologies | countries | application-area | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
style |
|
|
|
|
Use approved suffixes on Label and TextConst names (CodeCop AA0074)
Description
CodeCop AA0074 flags Label and TextConst identifiers that do not end with an approved usage suffix. The suffix signals at the call site how the text is consumed and what translation behaviour it should get. The approved suffixes and their intended usage are: Msg for text shown via Message(); Err for text passed to Error(); Qst for text used with Confirm or StrMenu; Lbl for captions and tooltips; Tok for short tokens such as 'GET', 'PUT', 'HTTPS', GUIDs, or JSON/XML snippets that are not translated (typically with Locked = true); and Txt for general text including telemetry messages. A Label named Text000 or CannotDeleteLine without a suffix violates the rule, regardless of how readable the prose is.
Best Practice
Pick the suffix that matches the call where the label is consumed: UpdateCompleteMsg for Message(...), CustomerNotFoundErr for Error(...), DeleteRecordQst for Confirm(...), CustomerNameLbl for tooltips and captions, GetMethodTok for locked tokens, TelemetryDataTxt for telemetry payloads. Suffix choices between Tok, Lbl, Txt, and Msg are judgment calls when the suffix is valid for the usage — what matters is that the suffix is on the approved list and matches the actual call.
See sample: label-suffix-approved-list.good.al.
Anti Pattern
A Label declared with no suffix (CannotDeleteLine: Label '…';), a generic name (Text000: Label '…';), or a suffix that contradicts the usage (WrongSuffixTok: Label 'Customer %1 not found.' then passed to Error()). All three trip AA0074 or its reviewers and obscure the call-site contract.
See sample: label-suffix-approved-list.bad.al.