bcquality/microsoft/knowledge/events
Jesper Schulz-Wedde 0ad92cad86 Refine events articles after review feedback
Correct wording in five events articles to reflect that AL event
subscribers bind by parameter name, not position:

- add-new-event-parameters-at-the-end: drop the inaccurate claim that
  appending a parameter forces subscribers to be updated or causes wrong
  values; keep the append-at-end best practice.
- do-not-add-ishandled-to-an-existing-event: reframe from "breaking
  change" to the semantic/purpose shift that leaves existing subscribers
  pointless; rename the breaking-change keyword to semantic-change.
- name-events-by-publisher-position: extend the good sample with
  position-named publishers raised from table and report trigger
  contexts.
- initialize-ishandled-to-false-before-publishing: scope the detection
  and best practice to events that actually carry a var IsHandled, so an
  OnBefore with no IsHandled is not flagged.
- do-not-bypass-critical-operations-with-ishandled: add a litmus-test
  definition of a critical operation (code that cannot stand as an
  independent, self-contained unit).

Knowledge-only; no contract or wiring change.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-06-25 11:59:00 +02:00
..
add-new-event-parameters-at-the-end.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
add-new-event-parameters-at-the-end.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
add-new-event-parameters-at-the-end.md Refine events articles after review feedback 2026-06-25 11:59:00 +02:00
avoid-loosely-typed-event-parameters.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
avoid-loosely-typed-event-parameters.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
avoid-loosely-typed-event-parameters.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
choose-static-vs-manual-subscribers-deliberately.bad.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
choose-static-vs-manual-subscribers-deliberately.good.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
choose-static-vs-manual-subscribers-deliberately.md Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
do-not-add-ishandled-to-an-existing-event.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-add-ishandled-to-an-existing-event.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-add-ishandled-to-an-existing-event.md Refine events articles after review feedback 2026-06-25 11:59:00 +02:00
do-not-bypass-critical-operations-with-ishandled.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-bypass-critical-operations-with-ishandled.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-bypass-critical-operations-with-ishandled.md Refine events articles after review feedback 2026-06-25 11:59:00 +02:00
do-not-publish-events-inside-loops.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-publish-events-inside-loops.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
do-not-publish-events-inside-loops.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
initialize-ishandled-to-false-before-publishing.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
initialize-ishandled-to-false-before-publishing.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
initialize-ishandled-to-false-before-publishing.md Refine events articles after review feedback 2026-06-25 11:59:00 +02:00
name-event-parameters-without-abbreviations.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
name-event-parameters-without-abbreviations.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
name-event-parameters-without-abbreviations.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
name-events-by-publisher-position.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
name-events-by-publisher-position.good.al Refine events articles after review feedback 2026-06-25 11:59:00 +02:00
name-events-by-publisher-position.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-reusing-or-extending-existing-events.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-reusing-or-extending-existing-events.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-reusing-or-extending-existing-events.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-this-over-includesender-in-codeunit-events.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-this-over-includesender-in-codeunit-events.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefer-this-over-includesender-in-codeunit-events.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefix-temporary-record-event-parameters-with-temp.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefix-temporary-record-event-parameters-with-temp.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
prefix-temporary-record-event-parameters-with-temp.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
preserve-onafter-execution-when-ishandled-skips-the-body.bad.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
preserve-onafter-execution-when-ishandled-skips-the-body.good.al Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
preserve-onafter-execution-when-ishandled-skips-the-body.md Add 12 general AL event-design articles to events domain 2026-06-25 11:58:59 +02:00
publish-thin-onbefore-onafter-integration-events.bad.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
publish-thin-onbefore-onafter-integration-events.good.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
publish-thin-onbefore-onafter-integration-events.md Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
use-ishandled-to-make-base-behaviour-overridable.bad.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
use-ishandled-to-make-base-behaviour-overridable.good.al Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00
use-ishandled-to-make-base-behaviour-overridable.md Add events knowledge domain and review leaf skill 2026-06-25 11:58:58 +02:00