Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-06 15:16:56 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Fix remaining READ-convention sample links across this PR's 18 articles

Browse source 
The same plain-backtick "See sample: \`x.good.al\`." form fixed on
al-methods-limited-during-write-transactions (PR #161) turned up
repo-wide on 15 more of this PR's articles - Knowledge-Retrieval.ps1
requires the markdown-link form to associate a sample with its
article. All 16 fixed; the four local validators (frontmatter,
knowledge-index, knowledge-retrieval, review-fixtures, skill-index)
pass.
This commit is contained in:
Michael Dieringer 2026-09-21 22:30:25 +02:00
parent faa0bceb86
commit b983a6da57
16 changed files with 32 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

4
microsoft/knowledge/data-modeling/do-not-change-primary-key.md
View file

@ -19,10 +19,10 @@ Once a table has shipped — to AppSource, or to any customer environment that h
Leave a published table's key exactly as shipped. Model a new discriminating dimension as a separate table with its own key instead of adding a field to the existing key, and branch orchestration code by the new dimension rather than filtering one shared table on an extra key field.
See sample: `do-not-change-primary-key.good.al`.
See sample: [`do-not-change-primary-key.good.al`](do-not-change-primary-key.good.al).
## Anti Pattern
Adding a field to a published table's primary or clustered key to distinguish a new case. This fails AppSource validation or any customer upgrade with `AS0009` as soon as rows already exist under the old key shape, whether the field is being added, removed, or reordered.
See sample: `do-not-change-primary-key.bad.al`.
See sample: [`do-not-change-primary-key.bad.al`](do-not-change-primary-key.bad.al).