Methodology and evidence grading: sources, scope, AI disclosure and corrections
This site's use of "evidence" is not a claim that it performs medical systematic reviews or turns citation counts into truth. It is an editorial constraint: every conclusion must state where its evidence came from, what that evidence can answer and what it cannot answer.
The common technical-writing failure is not a wrong number; it is copying a number from a secondary blog and promoting it from one room, device and version to a universal law. This page documents the workflow used to avoid that failure and the process for correcting it.
1. Classify the claim first
One source supports different claims with different strength:
| Claim type | Example | Appropriate evidence | Do not write |
|---|---|---|---|
| Platform rule | What AdSense eligibility currently says | current official page | "every account will be approved" |
| Method feasibility | a paper estimates respiration with CSI | peer-reviewed paper + reproduction | "every consumer router has medical accuracy" |
| This-device measurement | this project captured 57,293 records | raw data, scripts, commands, SHA-256 | "every MT6000 behaves identically" |
| Engineering inference | a 40 MHz client repeatedly slows in an 80 MHz BSS | one-variable A/B + driver logs | "one register is certainly the only root cause" |
| Future forecast | what 802.11bf may enable | standard scope + cautious wording | treating a roadmap as a shipped capability |
| Commercial claim | community project claims real-time spatial intelligence | vendor material as a lead | a conclusion without independent reproduction |
The verb must match the evidence. A first-party run says "the measured value was"; an inference says "more likely"; an untested question says "unknown"; an unreproduced marketing claim says "claimed, not independently verified."
2. A–E evidence grades
| Grade | Meaning | Typical source | What it can prove | What it cannot automatically prove |
|---|---|---|---|---|
| A | Standard / systematic review / authoritative consensus | IEEE standards, field surveys such as the CSI survey [1] | terminology, research boundaries, consensus | that a particular product will perform the same way at home |
| B | Peer-reviewed paper | INFOCOM / ICDCS / IMWUT and similar | that a method was validated under the paper's conditions | transfer to every room, chip and parameter |
| C | Official docs / first-party vendor material | platform rules, API docs, project README | how a product or command is defined | real-world performance, independent truth or long-term reliability |
| D | Preprint / encyclopedia / community material | arXiv, Wiki, community repos | research or implementation leads | peer review or independent reproduction |
| E | First-party reproducible measurement | captures, scripts, logs, SHA-256 | what happened in this published experiment | cross-device, cross-environment or cross-subject accuracy |
A and B are not a simple ladder. A standard answers "what is the specification"; a paper answers "what worked under these experimental conditions"; a first-party run answers "what happened on this device this time." A standard cannot replace a performance measurement, and one paper cannot replace reproduction on current firmware.
At the last update, the reference registry contains 51 verified sources (A 2 / B 16 / C 25 / D 3 / E 5). Each entry stores the title, authors/institution, year, URL or DOI, verification method and date. Articles may cite only stable IDs from that registry.
3. Pre-publication verification
3.1 External sources
- Write a falsifiable claim: object, variable, unit and scope;
- prefer primary material: paper DOI, standard page, official documentation, source code or release, not a secondary summary;
- record the level read: abstract, full text, appendix, official page or community discussion;
- verify metadata: use DOI/Crossref for title, authors, year and venue;
- preserve the relevant sentence: official and platform sources include the quote and access date;
- check the version: commands, firmware, APIs and policies change quickly;
- cross-check contested or high-risk claims with a second independent source or a reproducible experiment;
- downgrade uncertainty: remove unsupported text, mark it unknown, or label it as a hypothesis.
Standards and surveys establish context. For example, the IEEE 802.11bf project page proves that WLAN sensing is a standardisation effort [2]; it does not prove that any current router has a particular sensing accuracy.
3.2 First-party experiments
A grade-E claim needs:
- device, firmware/software version, date and environment;
- raw data or a minimal reproducible sample;
- parser/analysis scripts and their version;
- explicit quality gates, exclusions and failures;
- a SHA-256 or versioned DOI; data revisions get a new version;
- key numbers that can be recomputed from the raw data.
The public 10-minute capture and toolkit are the basis of this project's E-grade evidence [3] [4]. "The serial port has data" or "the plot looks like breathing" is not validation; record count, timeline, gaps, matrix shape and hashes must agree.
4. Article review checklist
| Check | Pass condition |
|---|---|
| Citation exists | DOI/URL resolves and author/title match |
| Source directly supports the sentence | the original discusses the same object and metric |
| Number reproduces | unit, denominator, sample count and script agree |
| Causality is not invented | observation is not promoted to root cause |
| Scope matches | paper conditions and device model match the article |
| Failure is disclosed | anomalies, unknowns and failed runs are visible |
| Commercial relationship is clear | ads, affiliates or sponsorship do not change conclusions |
| Update is real | substantive changes carry a real review date |
Automated builds, link checks and screenshot QA prove that the site is reachable and the layout does not overflow. They do not prove a paper's conclusion or a device's performance. Technical QA and factual review are separate processes.
5. Search and source selection
This site is not a systematic review and does not claim exhaustive search. The workflow normally includes:
- use Crossref/DOI for authoritative paper metadata;
- follow the paper and its references to the original experiment;
- check standards, official docs, code and releases;
- use GitHub metadata to verify that a tool exists, its license and last update;
- seek independent papers or reproduction for marketing claims rather than treating popularity as accuracy;
- record the access date. A historical fact is valid only for the date stated by the page.
High citation count means influence, not correctness. An official publication proves who published it, not product performance. Open source does not mean security-audited.
6. Data, figures and versions
- raw data and visualisations are stored separately; colour maps cannot change values;
- train/validation splits follow sessions or time, never random adjacent windows;
- report medians, percentiles, sample size and failures, not only the best-looking figure;
- distinguish
95.5 chain records/s,12.68 closed groups/sand12.64 groups/s after the documented filter[3]; - changes to statistics, chunks or field meanings update the manifest, SHA-256 and page;
- if a data revision changes meaning, publish a new version rather than silently replacing it.
7. AI-assistance disclosure
This site permits AI assistance for research organisation, drafting, translation, code suggestions, site implementation and test scaffolding, under these rules:
- AI is never a source and is not entered in the bibliography;
- external facts return to a primary paper, standard, official document or real measurement;
- commands, parsers and YAML are syntax-checked or run; otherwise they are clearly marked untested;
- the named human author remains accountable for the published text and risk;
- no fabricated citations, experiment results or user testimonials;
- medical, safety and privacy claims receive stronger review than prose quality.
AI improves organisation and proofreading, but it confidently invents APIs, numbers and references. Plausibility is not evidence.
8. Commercial independence
- ads, affiliate links and sponsorships are disclosed;
- a commercial relationship cannot buy a favourable conclusion, ranking or deletion of a negative measurement;
- products without first-party testing receive no performance endorsement;
- commercial pages may be
noindexduring review, but technical conclusions do not change with ad status; - prices, fees and availability are grade-C facts tied to their access date.
9. Severity-based corrections
| Severity | Example | Action |
|---|---|---|
| High | wrong medical/safety conclusion, data exposure, invented citation | remove or display a prominent correction first, then document the fix |
| Medium | recalculated number, compatibility change, broken critical command | update the page and updated date; state the affected scope |
| Low | typo, layout or dead non-critical link | fix directly; log only if part of a larger revision |
Changes to first-party data update checksums and, when necessary, create a new Zenodo version while preserving the old DOI. A retracted paper, corrected source or removed official document is downgraded or rewritten at the next review; the old conclusion is not silently preserved.
10. Scope and responsibility
This site is for technical research and learning. Human-sensing material is not a medical device, diagnosis, safety certification, insurance or legal advice. Deployment requires authorisation, household disclosure and compliance with local privacy law. Any automation needs a failure path and human review.
Report an error, failed reproduction or dead citation with the page URL, exact paragraph and supporting evidence to okwujun@gmail.com. Reproducible counterexamples receive priority.
The reference list is generated automatically at the end of this page; its count and grade distribution follow the registry.
References and data sources
Every external claim carries a source and an evidence grade (grading scheme). Grade E marks first-party, reproducible measurements from this project.
- Grade A · standard/review
WiFi Sensing with Channel State Information: A Survey
W. Ma, W. Zhou, X. Wang · ACM Computing Surveys · 2019
doi:10.1145/3310194 · citations 857 · verified: CrossRef API, 2026-10-11 · The field's most-cited CSI sensing survey (857 citations, verified via CrossRef). - Grade A · standard/review
IEEE 802.11bf — WLAN Sensing (standard project)
IEEE Standards Association · IEEE 802.11 Working Group · 2020
standards.ieee.org/ieee/802.11bf/10331/ · verified: standards.ieee.org HTTP 200, 2026-10-11 · Official project page for turning sensing into a WLAN standard capability (approved September 2020). - Grade E · first-party measurement
This project's 10-minute raw capture (57,293 records / 600.0 s, SHA-256 00373f83…95e2)
Router CSI Lab · 2026
okwujun.pw/en/datasets/ · verified: Reassembled chunks verified byte-identical (2026-10-11) · The local raw master has SHA-256 00373f83…95e2; the public de-identified derivative has SHA-256 527466ce…a440. They must not be confused. - Grade E · first-party measurement
Router CSI Toolkit — capture/analysis/watchdog scripts (MIT, public repository)
Router CSI Lab · 2026
github.com/jjjwu/router-csi-toolkit · verified: GitHub API verified the public repository, capture-quality preflight, successful CI and the v0.1.3 release on 2026-11-02; the archive SHA-256 is 59f144c0…adea7 · The public repository includes a dependency-free capture preflight; the browser checker uses the same container definition and evidence boundaries.