1"use strict";(self.webpackChunkneural_audio_theory=self.webpackChunkneural_audio_theory||[]).push([["6816"],{3177(e,i,n){n.r(i),n.d(i,{metadata:()=>r,default:()=>h,frontMatter:()=>a,contentTitle:()=>l,toc:()=>c,assets:()=>d});var r=JSON.parse('{"id":"engineering/reliability-and-sourcing","title":"Reliability and Sourcing","description":"Neural Audio Theory separates durable concepts from changing product behavior and unresolved research claims. This page explains how to interpret statements in the guide and how contributors should support them.","source":"@site/docs/engineering/reliability-and-sourcing.md","sourceDirName":"engineering","slug":"/engineering/reliability-and-sourcing","permalink":"/docs/engineering/reliability-and-sourcing","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"title":"Reliability and Sourcing"},"sidebar":"engineeringSidebar","previous":{"title":"Engineering Docs Home","permalink":"/docs/engineering"},"next":{"title":"Digital Audio Basics","permalink":"/docs/audio-fundamentals/digital-audio-basics"}}'),t=n(4848),s=n(8453);let a={title:"Reliability and Sourcing"},l="Reliability and Sourcing",d={},c=[{value:"Evidence hierarchy",id:"evidence-hierarchy",level:2},{value:"Claim labels",id:"claim-labels",level:2},{value:"Time-sensitive claims",id:"time-sensitive-claims",level:2},{value:"Quantitative claims",id:"quantitative-claims",level:2},{value:"Corrections policy",id:"corrections-policy",level:2},{value:"Scope boundaries",id:"scope-boundaries",level:2}];function o(e){let i={a:"a",code:"code",h1:"h1",h2:"h2",header:"header",li:"li",ol:"ol",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(i.header,{children:(0,t.jsx)(i.h1,{id:"reliability-and-sourcing",children:"Reliability and Sourcing"})}),"\n",(0,t.jsx)(i.p,{children:"Neural Audio Theory separates durable concepts from changing product behavior and unresolved research claims. This page explains how to interpret statements in the guide and how contributors should support them."}),"\n",(0,t.jsx)(i.h2,{id:"evidence-hierarchy",children:"Evidence hierarchy"}),"\n",(0,t.jsx)(i.p,{children:"Prefer evidence in this order:"}),"\n",(0,t.jsxs)(i.ol,{children:["\n",(0,t.jsx)(i.li,{children:"specifications, standards, laws, and first-party product documentation;"}),"\n",(0,t.jsx)(i.li,{children:"peer-reviewed papers or original technical reports;"}),"\n",(0,t.jsx)(i.li,{children:"official source code, model cards, datasets, and release notes;"}),"\n",(0,t.jsx)(i.li,{children:"reproducible measurements with disclosed settings and artifacts;"}),"\n",(0,t.jsx)(i.li,{children:"clearly labeled secondary analysis;"}),"\n",(0,t.jsx)(i.li,{children:"anecdotal observations, used only to motivate a test."}),"\n"]}),"\n",(0,t.jsx)(i.p,{children:"A citation establishes only what its source demonstrates. A model paper does not automatically describe a hosted product with the same brand, and a benchmark score does not transfer to another dataset or preprocessing pipeline."}),"\n",(0,t.jsx)(i.h2,{id:"claim-labels",children:"Claim labels"}),"\n",(0,t.jsx)(i.p,{children:"Use explicit language for claims about systems that are not fully public:"}),"\n",(0,t.jsxs)(i.table,{children:[(0,t.jsx)(i.thead,{children:(0,t.jsxs)(i.tr,{children:[(0,t.jsx)(i.th,{children:"Label"}),(0,t.jsx)(i.th,{children:"Required support"})]})}),(0,t.jsxs)(i.tbody,{children:[(0,t.jsxs)(i.tr,{children:[(0,t.jsx)(i.td,{children:(0,t.jsx)(i.strong,{children:"Documented"})}),(0,t.jsx)(i.td,{children:"A current first-party source or primary publication states it"})]}),(0,t.jsxs)(i.tr,{children:[(0,t.jsx)(i.td,{children:(0,t.jsx)(i.strong,{children:"Observed"})}),(0,t.jsx)(i.td,{children:"A dated, reproducible test demonstrates it"})]}),(0,t.jsxs)(i.tr,{children:[(0,t.jsx)(i.td,{children:(0,t.jsx)(i.strong,{children:"Inferred"})}),(0,t.jsx)(i.td,{children:"Evidence supports a hypothesis but does not confirm the mechanism"})]}),(0,t.jsxs)(i.tr,{children:[(0,t.jsx)(i.td,{children:(0,t.jsx)(i.strong,{children:"Unknown"})}),(0,t.jsx)(i.td,{children:"Public evidence is insufficient"})]})]})]}),"\n",(0,t.jsx)(i.p,{children:"Do not use \u201Clikely,\u201D \u201Cappears to,\u201D or output artifacts as a substitute for this distinction. Inference can guide experiments but should not be presented as architecture fact."}),"\n",(0,t.jsx)(i.h2,{id:"time-sensitive-claims",children:"Time-sensitive claims"}),"\n",(0,t.jsx)(i.p,{children:"Treat these as volatile:"}),"\n",(0,t.jsxs)(i.ul,{children:["\n",(0,t.jsx)(i.li,{children:"API endpoints, request fields, authentication, quotas, prices, and model names;"}),"\n",(0,t.jsx)(i.li,{children:"hosted product features, duration limits, formats, and plan rights;"}),"\n",(0,t.jsx)(i.li,{children:"software versions and hardware performance;"}),"\n",(0,t.jsx)(i.li,{children:"laws, court decisions, regulatory guidance, and provider terms;"}),"\n",(0,t.jsx)(i.li,{children:"public availability and licenses of datasets or model weights."}),"\n"]}),"\n",(0,t.jsx)(i.p,{children:"Time-sensitive statements should link a first-party source and state when they were checked when the date materially affects interpretation. Avoid duplicating a provider's complete reference; explain the integration pattern and send readers to the live contract."}),"\n",(0,t.jsx)(i.h2,{id:"quantitative-claims",children:"Quantitative claims"}),"\n",(0,t.jsx)(i.p,{children:"Every performance number needs enough context to reproduce or reject it:"}),"\n",(0,t.jsxs)(i.ul,{children:["\n",(0,t.jsx)(i.li,{children:"dataset and split;"}),"\n",(0,t.jsx)(i.li,{children:"sample count and independent evaluation unit;"}),"\n",(0,t.jsx)(i.li,{children:"sample rate, channels, duration, and preprocessing;"}),"\n",(0,t.jsx)(i.li,{children:"model checkpoint, precision, sampler, and candidate budget;"}),"\n",(0,t.jsx)(i.li,{children:"metric implementation and embedding checkpoint;"}),"\n",(0,t.jsx)(i.li,{children:"hardware, runtime, batch size, warm-up, and timing boundary;"}),"\n",(0,t.jsx)(i.li,{children:"uncertainty or repeated-run variation."}),"\n"]}),"\n",(0,t.jsx)(i.p,{children:"Numbers without matched conditions should not be combined into a leaderboard."}),"\n",(0,t.jsx)(i.h2,{id:"corrections-policy",children:"Corrections policy"}),"\n",(0,t.jsx)(i.p,{children:"When correcting a page:"}),"\n",(0,t.jsxs)(i.ol,{children:["\n",(0,t.jsx)(i.li,{children:"preserve useful context while removing unsupported certainty;"}),"\n",(0,t.jsx)(i.li,{children:"replace secondary summaries with primary sources when practical;"}),"\n",(0,t.jsx)(i.li,{children:"explain operating conditions and limitations next to the claim;"}),"\n",(0,t.jsx)(i.li,{children:"update related pages, navigation, and examples that repeat the claim;"}
1),"\n",(0,t.jsxs)(i.li,{children:["run ",(0,t.jsx)(i.code,{children:"npm run check"})," before opening the pull request;"]}),"\n",(0,t.jsx)(i.li,{children:"describe the evidence and reader impact in the pull request."}),"\n"]}),"\n",(0,t.jsxs)(i.p,{children:["Report suspected errors through ",(0,t.jsx)(i.a,{href:"https://github.com/edujbarrios/neural-audio-theory/issues",children:"GitHub Issues"}),". Include the page, exact claim, proposed correction, and strongest available source. Never include credentials, private audio, or personal information."]}),"\n",(0,t.jsx)(i.h2,{id:"scope-boundaries",children:"Scope boundaries"}),"\n",(0,t.jsx)(i.p,{children:"This project is educational. Technical explanations are not legal advice, licensing clearance, safety certification, or a guarantee that a provider will preserve behavior. For consequential releases or deployments, verify the primary material and obtain qualified review appropriate to the jurisdiction and risk."}),"\n",(0,t.jsxs)(i.p,{children:["Continue with ",(0,t.jsx)(i.a,{href:"/docs/training/benchmark-design",children:"Benchmark Design"})," for experimental comparisons and ",(0,t.jsx)(i.a,{href:"/docs/training/evaluation-metrics",children:"Evaluation Metrics"})," for measurement design."]})]})}function h(e={}){let{wrapper:i}={...(0,s.R)(),...e.components};return i?(0,t.jsx)(i,{...e,children:(0,t.jsx)(o,{...e})}):o(e)}},8453(e,i,n){n.d(i,{R:()=>a,x:()=>l});var r=n(6540);let t={},s=r.createContext(t);function a(e){let i=r.useContext(s);return r.useMemo(function(){return"function"==typeof e?e(i):{...i,...e}},[i,e])}function l(e){let i;return i=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),r.createElement(s.Provider,{value:i},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.