source-academy / js-slang / 35731529354

86%

push

github

docs: fix remaining Source references on the /javascript landing page (#2094)

- Landing page headline: the <title>/<h1> aren't sourced from
  README_top.md - the jsdoc template derives them from the local
  build folder's basename ("source" for the landing config), which is
  unrelated to the /javascript deploy destination and can't be turned
  into "JavaScript sublanguages for SICP JS" by any folder-name
  transform. jsdoc's --mainpagetitle "override" is dead code (not a
  real registered CLI flag - confirmed jsdoc itself rejects it), so
  scripts/docs.mjs now patches the built index.html's two known
  auto-generated strings directly after the jsdoc build, failing
  loudly if the template ever changes them.

- Style guide: renamed "Source Style Guide" -> "JavaScript Style
  Guide" in both the on-page link and the PDF's own title/header
  (source_styleguide.tex), plus a handful of body sentences that
  contrasted "Source" against "JavaScript" and needed rewording to
  avoid becoming "JavaScript" vs "JavaScript" once both sides read the
  same word.

- Every href on the page: nine deprecated-variant specs (WebAssembly,
  the four Typed variants, Explicit-Control, Infinite Loop Detection,
  Stepper, Type Inference) plus the style guide previously linked to
  source_*.pdf/source_*/ - these are out of scope for renaming their
  own body content (unsupported/deprecated variants, per earlier
  scoping), but the user asked that the *links themselves* not say
  "source" either. Added a javascript_* forwarding alias
  (`\input source_*.tex`) for each PDF, and a matching
  'JavaScript ...' config entry in scripts/docs.mjs for each folder
  page, reusing the same READMEs - same "new alias, old kept for
  compat, content unchanged" shape as the four main chapters, just in
  the other direction (source_* stays real; javascript_* forwards to
  it) since there's no renamed content to make canonical here.

Verified end-to-end: `node scripts/docs.mjs prepare` builds ... (continued)

2517 of 3052 branches covered (82.47%)

Branch coverage included in aggregate %.

4915 of 5622 relevant lines covered (87.42%)

348232.95 hits per line