DV Digest

Home›Documentation

Documentation · release 1

How it was decided, built and proved

The working documents of release 1, The Acquired Book, rendered as they are kept. Start with the design: it is the technical guide to every Data Vault choice.

Release 1 · The Acquired Book

Seven documents, one release

Design

Every Data Vault choice, argued: business keys, hashing, satellites per source, ghost records, inspectors and auditors, decisions D-1 to D-52.

Read

Product definition

Mary's questions, the metrics they need, the open points settled, and the named releases.

Read

Profile

What the source data actually holds, measured before anything was designed.

Read

Test plan

Every test, by layer, and the requirement each one proves.

Read

Implementation guide

The build, step by step, with its code and its exemplars.

Read

Post-implementation guide

What shipped, the evidence, and every difference from the plan, with why.

Read

QA certification

The QA cycle: preparation, the build, the tests, the comparisons, and the verdict on six gates.

Read

Next · What We Knew When, in QA

Four more documents

The design, test plan and implementation guide above are one set, worked as each release adds to them, so they now carry both releases.

Mart design

Mary's questions served from the conformed mart: its grains, its keys, and the meaning each measure carries.

Read

Post-implementation guide

What the next release shipped, the evidence, and every difference from the plan, with why.

Read

QA certification

The next release's QA cycle: preparation, the build, the tests and the verdict, filled in as it runs.

Read

Code review

The review of the next release's code: what was checked against data, each finding and where it stands.

Read

Reading them

Kept as they are worked

The documents keep the team's working shorthand: decisions are numbered (D-1, D-2), questions are Q-numbered, and answers such as “1y” record who agreed what and when. Every claim points to its evidence.

52
design decisions, each with its reason
137
tests, each tied to a requirement
32
deltas from plan, each explained
7
documents per release

Start with the design

Every Data Vault choice in this platform, argued and tied to its evidence.

Read the design