← Commit history

remove em-dashes from description and README prose

John Lauer ·3840fba4d1 ·3mo ago ·parent 249126f
3 files changed +12−12
README.md+9−9
@@ -2,8 +2,8 @@  > **Reference page.** This page was prepared for the NSF PCL FAIR-data due diligence > (July 2026) as a working sample of how every Adom experiment is published. The-> experiment is a **computed characterization** — a closed-form model evaluated by the-> included code, not a bench measurement — and is **fully reproducible bit-for-bit**+> experiment is a **computed characterization**: a closed-form model evaluated by the+> included code, not a bench measurement: and is **fully reproducible bit-for-bit** > from the files on this page. Real bench experiments follow this exact same structure, > with instrument captures (oscilloscope/spectrum-analyzer screenshots and CSV/JSON > exports) in place of the model.@@ -11,7 +11,7 @@ ## Objective  Characterize the frequency response (magnitude and phase) of a first-order RC low-pass-filter — R = 1 kΩ, C = 100 nF — from 10 Hz to 1 MHz, and publish the result the standard+filter (R = 1 kΩ, C = 100 nF) from 10 Hz to 1 MHz, and publish the result the standard Adom way: write-up + JSONL dataset + sidecar metadata + provenance + the AI skill that reproduces it. @@ -19,7 +19,7 @@ reproduces it.  The transfer function `H(f) = 1 / (1 + j·2πf·RC)` is evaluated at 20 points per decade (101 points total). Expected cutoff: `fc = 1/(2πRC) ≈ 1591.5 Hz`. The whole run is-deterministic — `python3 analysis/run_experiment.py` regenerates the dataset, its+deterministic: `python3 analysis/run_experiment.py` regenerates the dataset, its sidecar, and the plot exactly.  ## Results@@ -36,12 +36,12 @@ sidecar, and the plot exactly.  | FAIR concern | Where it lives on this page | |---|---|-| **Data** | [`data/rc_lowpass_response.jsonl`](data/rc_lowpass_response.jsonl) — one JSON row per point: `frequency_hz`, `gain_linear`, `gain_db`, `phase_deg` |-| **Metadata** | [`data/rc_lowpass_response.sidecar.json`](data/rc_lowpass_response.sidecar.json) — the sidecar JSON **is the dataset's metadata**: a small file that rides alongside the data with its schema (fields + units), parameters, generator, row count, sha256, and license |-| **Provenance** | [`provenance.json`](provenance.json) — who ran it (human-prompted, AI-executed), the input model and code, design-reference part numbers, output hashes, and the full chain from request to publication |-| **Reproducibility** | [`skills/reproduce-rc-characterization/SKILL.md`](skills/reproduce-rc-characterization/SKILL.md) — the AI skill; one command regenerates everything |+| **Data** | [`data/rc_lowpass_response.jsonl`](data/rc_lowpass_response.jsonl): one JSON row per point: `frequency_hz`, `gain_linear`, `gain_db`, `phase_deg` |+| **Metadata** | [`data/rc_lowpass_response.sidecar.json`](data/rc_lowpass_response.sidecar.json): the sidecar JSON **is the dataset's metadata**, a small file that rides alongside the data with its schema (fields + units), parameters, generator, row count, sha256, and license |+| **Provenance** | [`provenance.json`](provenance.json): who ran it (human-prompted, AI-executed), the input model and code, design-reference part numbers, output hashes, and the full chain from request to publication |+| **Reproducibility** | [`skills/reproduce-rc-characterization/SKILL.md`](skills/reproduce-rc-characterization/SKILL.md): the AI skill; one command regenerates everything | | **Persistent identifier** | this page's URL: `wiki.adom.inc/adom/sample-experiment-rc-lowpass` (git-backed and versioned) |-| **Timeline** | published immediately on completion — no embargo |+| **Timeline** | published immediately on completion, no embargo |  ## Reproduce it 
package.json+2−2
@@ -3,7 +3,7 @@   "title": "Sample Experiment: RC Low-Pass Filter Response",   "type": "app",   "version": "1.0.0",-  "description": "Working sample of Adom's experiment publication format \u2014 JSONL data, sidecar metadata, provenance, and an AI reproduction skill. Prepared for NSF PCL FAIR-data due diligence.",+  "description": "Working sample of Adom's experiment publication format: JSONL data, sidecar metadata, provenance, and an AI reproduction skill. Prepared for NSF PCL FAIR-data due diligence.",   "tags": [     "experiment",     "sample",@@ -39,7 +39,7 @@   },   "hero": {     "headline": "Sample Experiment: RC Low-Pass Filter Response",-    "subhead": "A one-line tagline (replace me).",+    "subhead": "How every Adom experiment ships: JSONL data, sidecar metadata, provenance, and the AI skill that reproduces it.",     "screenshot": "docs/hero.png"   },   "license": "CC-BY-4.0",
page.json+1−1
@@ -3,7 +3,7 @@   "title": "Sample Experiment: RC Low-Pass Filter Response",   "type": "app",   "version": "1.0.0",-  "description": "Working sample of Adom's experiment publication format \u2014 JSONL data, sidecar metadata, provenance, and an AI reproduction skill. Prepared for NSF PCL FAIR-data due diligence.",+  "description": "Working sample of Adom's experiment publication format: JSONL data, sidecar metadata, provenance, and an AI reproduction skill. Prepared for NSF PCL FAIR-data due diligence.",   "tags": [     "experiment",     "sample",