mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-10-05 14:46:55 +01:00
f6fca1d56d
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
48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
# 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
|
|
|
|
```powershell
|
|
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.
|