Remove design-rationale phrasing from site copy and READMEs
4 changed files+14−28
README.mdmodified+8−9View file
@@ -10,15 +10,14 @@ discretization, which quietly decides much of the outcome. Here each
1010 a solver chooses its own discretization and is scored at
1111 problem-specified evaluation points. The central object is the
1212 **work-precision curve**: error against compute time as the solver's
13-resolution varies. There is deliberately no single ranking, since which
14-curve wins can differ by accuracy regime, instance, and machine.
13+resolution varies. No single ranking is presented; which curve wins can
14+differ by accuracy regime, instance, and machine.
1515
1616 Solvers are MATLAB function files run by [numbl](https://numbl.org)
1717 (MATLAB syntax in the browser and in node), so every run on this site
1818 happens client side, and the identical harness runs from the command
1919 line. Each problem defines its own interface and instances in a written
20-specification; the system is deliberately loose, and per-problem
21-interfaces are expected to differ.
20+specification; interfaces are per problem rather than shared.
2221
2322 ## Problems
2423
@@ -31,11 +30,11 @@ interfaces are expected to differ.
3130
3231 Results are work-precision sweeps stored as JSON files in
3332 [fastandaccurate-results](https://github.com/concept-collection/fastandaccurate-results)
34-and added by pull request; the site reads that repository statically, so
35-there is no database and no server. Every result records its provenance:
36-instance spec and hash, solver id and version, protocol, runtime, numbl
37-version, and machine. In-browser results can be rerun by any visitor on
38-their own machine directly on the site.
33+and added by pull request; the site reads that repository statically.
34+Every result records its provenance: instance spec and hash, solver id
35+and version, protocol, runtime, numbl version, and machine. Solvers
36+included on the site can be rerun in the browser on the problem page to
37+compare against the committed curves.
3938
4039 ## Running benchmarks outside the browser
4140
src/app/pages/AboutPage.tsxmodified+2−3View file
@@ -44,9 +44,8 @@ export function AboutPage() {
4444 Result files are produced by the command line; solvers included on
4545 the site can also be rerun in the browser, directly on the problem
4646 page, to compare against the committed curves. Results from solvers
47- outside the repository (and, in the future, from other languages and
48- hardware) enter the same way and are marked as not reproducible in
49- the browser.
47+ outside the repository enter the same way and are marked as not
48+ reproducible in the browser.
5049 </p>
5150
5251 <h2>Running outside the browser</h2>
src/app/pages/HomePage.tsxmodified+1−3View file
@@ -31,9 +31,7 @@ export function HomePage() {
3131 ))}
3232 </div>
3333 <p className="small muted" style={{ marginTop: 16 }}>
34- More problems are planned: further 2D problems (Helmholtz,
35- time-dependent), 3D problems, and near-boundary evaluation variants.
36- Suggestions and contributions are welcome on{" "}
34+ Suggestions and contributions of problems and solvers are welcome on{" "}
3735 <a href="https://github.com/concept-collection/fastandaccurate">GitHub</a>.
3836 </p>
3937 </>
src/app/pages/ProblemPage.tsxmodified+3−13View file
@@ -10,7 +10,6 @@ import {
1010 environmentLabel,
1111 fetchCommittedResults,
1212 isResultFile,
13- RESULTS_REPO_URL,
1413 } from "../results";
1514 import { solverColorVar } from "../colors";
1615 import { sweepInBrowser } from "../workerClient";
@@ -299,15 +298,13 @@ export function ProblemPage({ problemId }: { problemId: string }) {
299298 {runStatus && <p className="small muted">{runStatus}</p>}
300299 <h3>Run this on your machine</h3>
301300 <p className="small muted" style={{ maxWidth: 640 }}>
302- Browser runs are for comparison only; result files are produced
303- outside the browser. This command runs the{" "}
301+ This command runs the{" "}
304302 {visibleSolverList.length === 1
305303 ? `${visibleSolverList[0].id} sweep`
306304 : "same sweeps"}{" "}
307305 on the <code>{instanceId}</code> instance (node 20 or newer) and
308- writes result JSON files, which can be loaded below to see them on
309- this chart, and submitted by pull request (see{" "}
310- <a href="#/about">About</a>).
306+ writes result JSON files. Load them below to see them on this chart,
307+ or submit them by pull request (see <a href="#/about">About</a>).
311308 </p>
312309 <div className="row" style={{ alignItems: "flex-start", gap: 10 }}>
313310 <pre style={{ margin: 0, flex: "1 1 420px", overflowX: "auto" }}>
@@ -344,13 +341,6 @@ export function ProblemPage({ problemId }: { problemId: string }) {
344341 the error is the absolute pointwise difference on a log scale.
345342 </p>
346343 <SolutionSection inst={inst} />
347-
348- <p className="small muted" style={{ marginTop: "2.2rem" }}>
349- Result files are produced with the command line (above) and
350- submitted by pull request to the{" "}
351- <a href={RESULTS_REPO_URL}>results repository</a>; see{" "}
352- <a href="#/about">About</a>.
353- </p>
354344 </>
355345 );
356346 }