github-actions[bot]
commented
12 months ago This issue has been automatically marked as stale because it has not had activity in the last 90 days. It will be closed in the next 30 days unless it is tagged properly or other activity occurs.
For maintainers: Please label with bug, in progress, on hold, discussion or to do to prevent the issue from being re-flagged.
Issue Description
With Firefox and a default uMatrix setup, the docs site sits at "Loading..." permanently, unable to load resources from
unpkg.com(which I know from being a developer myself means the docs site is fully client-side rendered using JavaScript loaded over that quasi-CDN).For absolute giggles I then tried loading the docs site through NetSurf, a minimalist browser for low-resource machines that - while rare - some folks do use as their primary browser, particularly some folks on horrible, slow network connections in the middle of nowhere on conventionally-low-powered computers. Here, it's even worse: no "Loading...", just a plain white screen and absolutely nothing happens (I presume the JS files probably got downloaded, but NetSurf mostly doesn't support JavaScript, and so nothing happens).
At a minimum I think these docs should have a plain-HTML (and optionally CSS) fallback option for those using NetSurf, Links, or strict firewalling rules. While the viewing experience for, say, the Rust Language docs is admittedly pretty bad in NetSurf, it at least works at all, and for document-based help guides, that's better than absolutely nothing.
I feel some moral obligation to disclose my loose still-affiliation with another keyboard firmware, KMK, of which I was the original author, but I don't open this issue in any way in affiliation with that project - I'm setting up a personal QMK board today and ran into this speed bump and wanted to report it for my own sake and without any sort of interest in sparking a cross-project bout of drama. Much love, y'all, and thanks!