Root cause of "menu overlaps content" on the live site: Cloudflare's
edge cache kept serving a stale css/wosa-menu.css from before a fix,
under the same unversioned URL. wosaAssetVer() appends ?v=<filemtime>
to style.css, css/wosa-menu.css, flow-data.js, and app.js, so any edit
to those files automatically gets a new URL -- no more manual cache
purges needed after future deploys. (Still needs one manual purge on
the existing stale cache entry to pick this up immediately.)
Covers the ES5/no-flexbox browser constraints, the flow-data.js content
shape (node/option/step, function-valued fields), the device-filter and
auto-select mechanisms, the index.php server-side menu-nav fetch, and
the git branch layout (old-version preserves the pre-rewrite docs site
history) -- enough for someone else to pick this up cold.
The 320px source images were being downscaled ~9:1 by CSS to fit the
36px display size -- old WebKit's naive scaler handles that ratio
badly (visible aliasing on TouchPad). Pre-scaling to 72x72 (2x the
36px CSS size) cuts that to a clean 2:1 ratio while keeping a crisp
@2x source for modern high-DPI screens.
index.html becomes index.php: fetches www.webosarchive.org/menu.php
server-side over the same protocol the request arrived on (never
upgrading http to https) and inlines the result directly into the
page. A client-side XHR fetch was ruled out -- www.webosarchive.org
sends no CORS headers, so the browser would just block it; a local
same-origin menu.php proxy (the old docs site's approach) was also
ruled out in favor of loading straight from the root domain, keeping
this repo free of a duplicated proxy file.
css/wosa-menu.css positions the fixed-top mount div and reserves page
space for it, only when index.php's fetch actually succeeded.
Also folds in manual edits already on disk: README.md replaces the
now-redundant Help-Flow.txt/webOSDoctors.txt working notes, plus small
flow-data.js wording tweaks.
codepoet80