Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-05 14:46:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/coverage/README.md
Jesper Schulz-Wedde f6fca1d56d Close AL development contract gaps 
Bound post-implementation review rounds, expose output kinds in Entry
dispatch, enforce capability coverage, map BCFIX-HANDOFF v1, clarify
no-knowledge behavior, and reject repository-escaping skill paths.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 638b66d2-9f06-4f60-8781-808709e1485c
2026-09-04 13:36:49 +02:00

1.9 KiB
Raw Blame History

Developer knowledge coverage

This directory separates source coverage from the knowledge corpus itself. Microsoft Learn units are inputs to editorial work, not articles to import one-for-one.

Files

  • microsoft-learn-developer-catalog.json is generated source metadata for all Microsoft Learn modules tagged with both dynamics-business-central and developer.
  • learn-coverage.json is the maintained editorial ledger. Units absent from this file are unreviewed.
  • development-capabilities.json tracks whether representative Business Central development capabilities have implementation fixtures.

The capability manifest declares minimumFixtureCoverage. CI fails when the share of fixture or validated capabilities falls below that floor, so a new planned capability cannot silently dilute generation coverage.

Each tracked unit has a reviewStatus:

  • in-progress — at least one concern has been identified, but editorial triage of the unit is not complete.
  • complete — every relevant concern in the unit has a recorded outcome. A complete unit may have no outcomes when it contains no remedial knowledge.

Each concern has one disposition:

  • candidate — worth authoring or reconciling with existing knowledge.
  • authored — produced one or more new knowledge articles.
  • covered-existing — already represented by the linked article.
  • rejected — fails BCQuality's remedial admission test.
  • deferred — valid but intentionally postponed, with a rationale.

An authored article does not make its source unit complete automatically. One unit can contain several independent concerns.

Update and report

pwsh ./tools/Update-LearnCatalog.ps1
pwsh ./tools/Test-LearnCoverage.ps1

The catalog updater also accepts -CatalogPath for an exported Microsoft Learn Platform API response. CI validates the committed snapshot and editorial ledger without network access.