Standards traceability fixes and the target taxonomy (#118)
* docs: traceability fixes and the target taxonomy
Approved conclusions of the standards-traceability report:
Traceability (P1):
- the room-acoustics footer claimed ISO 3382-3:2022 while the code
implements and verifies :2012 - the footer now tells the truth
- CONFORMANCE.md becomes visible: a Reference page on the site (EN/ES)
explains the report and links the generated table (copying 300
auto-generated lines would drift), docs/README.md indexes it, and
why-phonometry links it after its comparison table
- nine citation patches with honest scoping: the ISO 1996-2 facade
claim reworded as measurement context; ECMA-74 out of the
tone-prominence footer (context note added); ISO 9613-1 declared in
surface-scattering with clause delimitation; materials cites the
BS EN ISO 10534:2001 editions the code cites; the EN 12354 typo;
ISO 266 and ISO 5725 added with narrow scope; IEC 61252 designations
unified
- class_limits exported (it was public-but-unimportable), documented in
the API reference and surfaced in filter-banks section 6
Taxonomy (approved target, sidebar moves only - zero URL changes):
- renamed: Signal processing & filters
- new groups: Instrumentation, calibration & compliance; Materials &
surfaces
- Perception & speech splits into Psychoacoustics (+tone-prominence),
Speech & intelligibility, and Hearing & occupational exposure
(+occupational-exposure)
- docs/README.md mirrors the new order; Conformance joins Reference
* docs: terminology polish on the new conformance pages
key differentiator (not 'differential asset'), governing band/frequency
(not 'binding'), pasa/no pasa, expresiones en forma cerrada, 'en la que
se basan las etiquetas nominales', and air-attenuation relations in
both languages (Gemini)
Audit pass 7: bilingual EN/ES consistency (#116)
* docs: bilingual EN/ES consistency batch
Audit batch 7 - the Spanish side catches up with the English one:
Content drift: the five per-architecture filter figures join the ES
filter-banks guide; the missing outdoor-propagation card joins the ES
index (7 cards on both sides); the sound-power card says five methods
in both languages (it said three since before ISO 3745/9614-3).
Decimals: the four prose dot-decimals and four code-comment
comma-decimals fixed per convention, and the systematic LaTeX {,}
migration lands - 146 conversions across 16 ES files, every hit
manually reviewed (clause numbers, standard designations, def.:
literals and code identifiers deliberately untouched; zero \d.\d
remain in ES math). The theory band-edge table keeps points (it
mirrors a code snippet's printed output); the why-phonometry report
tables convert to commas (prose).
Terminology unified: fonios, diezmado (including the divergent
multirate alt pair), umbral de audicion, banda atenuada, nivel de
evaluacion (including the rendered NT ACOU 112 ES diagram - the
generator string is fixed and only that SVG pair regenerated),
sharpness (agudeza), and clausula/apartado unified per file majority
(theory: clausula; api: apartado).
Code comments: 22 English comments translated across gum-uncertainty,
hearing-threshold, noise-induced-hearing-loss, room-noise and
occupational-exposure ES (the occupational f-string outputs were
re-executed and match the echoed comments byte-for-byte).
* docs: 'atenuación en banda atenuada' in the ES filter guide
The glossary fix produced a clumsy repetition ('atenuación de banda
atenuada'); the natural phrasing for stopband attenuation is 'en'
(Copilot).
* docs: the sound-power cards enumerate the guide's five routes exactly
The card grouped ISO 9614-2/3 into one item, making 'five routes' read
as four groups (or six standards); it now mirrors the guide's canonical
five-item enumeration, in both languages (CodeRabbit).