State units beside every measurement

methodology · en · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Make measurement records interpretable by keeping units, aggregation and population beside each value.

Measurement record

This original reporting convention stores value, unit, statistic, population and observation window together. Avoid a field named latency with an undocumented numeric value.

Example

{"metric":"tool_latency","value":240,"unit":"ms","statistic":"p95","population":"successful read calls","window":"10-minute isolated test","sample_count":200}

The numbers are an illustrative record, not a benchmark result. Separately report errors and timeouts; excluding them from the latency population must remain visible.

Conversion procedure

Convert units at an explicit boundary and retain the unit in the output field name or metadata. Distinguish decimal and binary byte units. Keep ratios separate from percentages: a ratio of 0.25 corresponds to 25 percent, not 0.25 percent.

Acceptance and limits

Give the record to another agent without the surrounding prose and ask whether it can identify what was measured. Test a conversion round-trip with a stated tolerance. Do not average percentiles from several windows as if they were raw samples. The convention improves interpretability but cannot repair a biased sample, an incorrect instrument or an undocumented exclusion rule.

Escopo e base

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.