docs: [verified] move metric contracts under Measurement
Build and publish Eldorado documentation / build (pull_request) Successful in 41s
Build and publish Eldorado documentation / build (pull_request) Successful in 41s
This commit is contained in:
1 parent
b9c2047c61
commit
85852f0744
45 files changed
+1101
-433
No files matched your search
@@ -6,25 +6,25 @@ const model = JSON.parse(read('research/ai-adoption/strategy-model.json'));
|
||||
|
||||
test('every strategy page leads with a compact diagram story and closes its references', () => {
|
||||
for (const {id} of model.pages) {
|
||||
const page = read(`docs/strategy/${id}.mdx`);
|
||||
const page = read(`docs/strategy/${id === 'measurement' ? 'measurement/index' : id}.mdx`);
|
||||
const narrative = page.split('<div className="strategy-content">')[1].replace(/<details>[\s\S]*?<\/details>/g, '');
|
||||
assert.equal((narrative.match(/<ArchifyDiagram /g) || []).length, id === 'roadmap' ? 3 : 1, id);
|
||||
assert(narrative.includes(' story />'), id);
|
||||
assert(!page.includes('<details>') || page.indexOf(' story />') < page.indexOf('<details>'), id);
|
||||
assert(!/<details\s+open/.test(page), id);
|
||||
assert.equal((page.match(/<details>/g) || []).length, (page.match(/<\/details>/g) || []).length, id);
|
||||
assert.equal((narrative.match(/^## /gm) || []).length, id === 'measurement' ? 4 : id === 'roadmap' ? 4 : 1, id);
|
||||
assert.equal((narrative.match(/^## /gm) || []).length, id === 'measurement' ? 5 : id === 'roadmap' ? 4 : 1, id);
|
||||
assert((narrative.match(/^- /gm) || []).length <= 3, id);
|
||||
assert(narrative.includes('**Next:**'), id);
|
||||
assert(!narrative.includes('| ---'), id);
|
||||
const words = narrative.replace(/<[^>]*>/g, '').trim().split(/\s+/).length;
|
||||
assert(words <= (id === 'measurement' ? 1100 : id === 'roadmap' ? 600 : 200), `${id}: ${words} default narrative words`);
|
||||
assert(words <= (id === 'measurement' ? 1500 : id === 'roadmap' ? 600 : 200), `${id}: ${words} default narrative words`);
|
||||
}
|
||||
});
|
||||
|
||||
test('mobile story diagrams preserve the same nodes and directed relationships', () => {
|
||||
for (const {id} of model.pages) {
|
||||
const page = read(`docs/strategy/${id}.mdx`);
|
||||
const page = read(`docs/strategy/${id === 'measurement' ? 'measurement/index' : id}.mdx`);
|
||||
const name = /<ArchifyDiagram name="([^"]+)"[^>]+ story/.exec(page)[1];
|
||||
if (name === 'strategy-roadmap') {
|
||||
const desktop = JSON.parse(read(`diagrams/${name}.workflow.json`));
|
||||
@@ -44,12 +44,12 @@ test('mobile story diagrams preserve the same nodes and directed relationships',
|
||||
});
|
||||
|
||||
test('all sixteen exact KPI formulas remain reachable in the linked reference', () => {
|
||||
assert(read('docs/strategy/measurement.mdx').includes('./reference/measurement-contracts.mdx'));
|
||||
const page = read('docs/strategy/reference/measurement-contracts.mdx');
|
||||
const contracts = page.split('## Metric contracts')[1].split('## Run the synthetic')[0];
|
||||
assert.equal((contracts.match(/^### /gm) || []).length, 16);
|
||||
const manifest = JSON.parse(read('research/ai-adoption/measurement-migration.json'));
|
||||
assert.equal(manifest.metrics.length, 16);
|
||||
for (const metric of model.kpis) {
|
||||
const section = contracts.split(`### ${metric.name}\n`)[1]?.split('\n### ')[0];
|
||||
const entry = manifest.metrics.find(m => m.title === metric.name);
|
||||
assert(read('docs/strategy/measurement/index.mdx').includes(`./${entry.oldAnchor}.mdx`));
|
||||
const section = read(`docs/strategy/${entry.docId}.mdx`);
|
||||
assert(section, metric.name);
|
||||
for (const label of ['Numerator','Denominator','Expression','Aggregation','Unit','Eligible population','Exclusions','Events and source','Owner / cadence','Missing evidence','Gaming and limits']) assert(section.includes(`| ${label} |`), `${metric.name}: ${label}`);
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user