mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-08-06 17:36:53 +01:00
62dabf9a11
The /samples/ top-level tree is replaced with sibling files in each
knowledge-layer folder. An article and its demonstrations now live
side-by-side:
microsoft/knowledge/<domain>/<slug>.md
microsoft/knowledge/<domain>/<slug>.good.al
microsoft/knowledge/<domain>/<slug>.bad.al
Rationale:
- Proximity. An article and its paired samples are one unit; the
filesystem now reflects that.
- Layer ownership. Samples inherit layer precedence for free -- a
/custom/ fork can override an article and its samples atomically,
which the shared /samples/ tree previously made awkward.
- Trivial migration path. Action-skill source globs
(*/knowledge/<domain>/**/*.md) are unchanged; sample discovery is a
sibling-filename lookup.
Changes:
- git mv of all 65 sample files from samples/<domain>/<slug>/{bad,good}.al
to microsoft/knowledge/<domain>/<slug>.{bad,good}.al (history preserved).
- Update See-sample references in all 37 articles that ship samples.
- skills/read.md: replace the no-code-blocks bullet with a pointer to a
new Sample files section that fully specifies the sibling convention,
the kinds (good/bad + forward-compatible), multi-technology rules,
demonstration-only status, and layer-precedence behaviour.
- skills/write.md: update the samples pointer to match.
- README.md: annotate the knowledge tree with the sample sibling shape.
- samples/README.md deleted; content lifted into skills/read.md.
- Both generators (C:\temp\gen_performance_knowledge.py,
C:\temp\gen_security_knowledge.py) updated to emit at the new paths
and to stop writing samples/README.md. Re-running them is idempotent
against the committed layout.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
||
|---|---|---|
| .. | ||
| add-sift-keys-for-flowfields.good.al | ||
| add-sift-keys-for-flowfields.md | ||
| avoid-calcfields-in-loops.bad.al | ||
| avoid-calcfields-in-loops.good.al | ||
| avoid-calcfields-in-loops.md | ||
| avoid-commit-inside-loops.bad.al | ||
| avoid-commit-inside-loops.md | ||
| avoid-findfirst-with-next.bad.al | ||
| avoid-findfirst-with-next.md | ||
| avoid-user-interaction-in-transactions.bad.al | ||
| avoid-user-interaction-in-transactions.good.al | ||
| avoid-user-interaction-in-transactions.md | ||
| filter-before-find.bad.al | ||
| filter-before-find.good.al | ||
| filter-before-find.md | ||
| keep-event-subscribers-lightweight.bad.al | ||
| keep-event-subscribers-lightweight.md | ||
| keep-transaction-scope-short.bad.al | ||
| keep-transaction-scope-short.good.al | ||
| keep-transaction-scope-short.md | ||
| only-fetch-records-you-use.bad.al | ||
| only-fetch-records-you-use.good.al | ||
| only-fetch-records-you-use.md | ||
| prefer-direct-record-over-recordref.bad.al | ||
| prefer-direct-record-over-recordref.good.al | ||
| prefer-direct-record-over-recordref.md | ||
| prefer-get-for-primary-key-lookups.bad.al | ||
| prefer-get-for-primary-key-lookups.good.al | ||
| prefer-get-for-primary-key-lookups.md | ||
| set-current-key-to-match-filters.good.al | ||
| set-current-key-to-match-filters.md | ||
| use-addloadfields-in-report-layouts.good.al | ||
| use-addloadfields-in-report-layouts.md | ||
| use-calcsums-for-flowfield-totals.bad.al | ||
| use-calcsums-for-flowfield-totals.good.al | ||
| use-calcsums-for-flowfield-totals.md | ||
| use-findset-readonly-by-default.bad.al | ||
| use-findset-readonly-by-default.good.al | ||
| use-findset-readonly-by-default.md | ||
| use-findset-with-next.bad.al | ||
| use-findset-with-next.good.al | ||
| use-findset-with-next.md | ||
| use-insert-false-when-skipping-triggers.good.al | ||
| use-insert-false-when-skipping-triggers.md | ||
| use-isempty-for-existence-checks.bad.al | ||
| use-isempty-for-existence-checks.good.al | ||
| use-isempty-for-existence-checks.md | ||
| use-setloadfields-for-partial-records.bad.al | ||
| use-setloadfields-for-partial-records.good.al | ||
| use-setloadfields-for-partial-records.md | ||
| use-single-instance-codeunits-for-caching.good.al | ||
| use-single-instance-codeunits-for-caching.md | ||
| use-strsubstno-for-message-formatting.bad.al | ||
| use-strsubstno-for-message-formatting.good.al | ||
| use-strsubstno-for-message-formatting.md | ||
| use-temporary-tables-for-intermediate-data.good.al | ||
| use-temporary-tables-for-intermediate-data.md | ||