mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-10-05 14:46:55 +01:00
56b80e6dcf
Add read-only planning and repository-changing development skills so BCQuality knowledge can guide features, bug fixes, refactors, upgrades, and maintenance before the existing AL review gate runs. Track Microsoft Learn ingestion and add development and BCApps-shaped guidance evaluation fixtures. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 638b66d2-9f06-4f60-8781-808709e1485c
44 lines
1.7 KiB
Markdown
44 lines
1.7 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.
|
|
|
|
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.
|