Repository navigation
Check the nine published pages, and give the Taguette export a head - #25
Merged
Merged
Conversation
tests.yml runs the Python and R suites and says nothing about the nine HTML files this repository serves. The traps are all written down in CLAUDE.md and none of them was checked by anything. taguette_coding/tag_summary_export.html opened with <html><body> and had no head at all: no viewport, no charset, no title, no lang. Without a viewport a phone lays the page out at desktop width and zooms out, so the text arrives too small to read, and it looks correct on the machine it was built on. Without a charset the curly quotes and the en dash in the exported transcript depend entirely on the server's default. The exported content is untouched; only a head is added above it. scripts/check_site.py runs 40 checks over the eight pages. Three are worth naming. GitHub Pages runs jekyll-readme-index, so a folder becomes a page only if it holds a README.md. The index links two folders, data_starters/dhs-south-asia/ and data_starters/plfs-india/, and both work only because they hold one. A folder link without a README is a 404 in production and a 200 under python -m http.server, which generates a directory listing; CLAUDE.md records that mistake shipping once. _config.yml must set no theme and must keep applying the default layout. Before that layout existed the config set theme: minima, and any rendered README opened in stock styling, so a click-through stopped looking like the site. And no page may carry its own <style> block, because the house style is one file shared verbatim across the stack repositories and a page reaching for its own CSS is how that quietly stops being true. Three checks were fault-injected against a real failure to confirm they bite. Also verified while doing this, and not changed because nothing was wrong: the landing page and all six calculators render at 390x844 with documentElement.scrollWidth equal to clientWidth, so the white-space: nowrap fix CLAUDE.md describes is holding. The only element outside the viewport is the skip link at -999px, which is where it belongs. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MrvR2NXsJFVRCeJZFCPuNL
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The gap
tests.ymlruns the Python and R suites, 120 checks across four suites in two languages. It says nothing about the nine HTML files this repository serves at https://varnasr.github.io/InsightStack/.Every trap below is already written down in
CLAUDE.md. None was checked by anything.The one real defect
taguette_coding/tag_summary_export.htmlbegan:No head at all. No viewport, no charset, no title, no
lang.Fixed by adding a head above the export. The exported content is untouched — it is a Taguette artefact and stays byte-identical.
scripts/check_site.py, 40 checks over 8 pagesThree are worth naming, and all three come straight out of
CLAUDE.md:A folder becomes a page only if it holds a
README.md. GitHub Pages runsjekyll-readme-index. The index links two folders,data_starters/dhs-south-asia/anddata_starters/plfs-india/, and both work only because they hold one. A folder link without a README is a 404 in production and a 200 underpython -m http.server, which generates a directory listing.CLAUDE.mdrecords that mistake shipping once._config.ymlmust set no theme and must keep applying the default layout. Before that layout existed, the config settheme: minimaand any rendered README opened in stock styling, so a click-through stopped looking like the site.No page may carry its own
<style>block. The house style is one file shared verbatim across the stack repositories; a page reaching for its own CSS is how that quietly stops being true, and the drift is invisible until two sites look different.Fault injection
Verified and not changed
CLAUDE.mdsays to load the landing page at 390×844 and comparedocumentElement.scrollWidthagainstclientWidth, because.row span'swhite-space: nowraponce pushed the page to 1384px against a 390px viewport. I measured it, in headless Chromium, on the landing page and all six calculators:The nowrap scoping is holding. The only element outside the viewport is the skip link at -999px, which is where it belongs. The same measurement on
FieldStack,EquityStackandSignalStacklanding pages is clean too.Also confirmed while checking:
CLAUDE.md's inventory of 9 HTML files is exactly right. I initially thought the calculators were missing becausels calculators/*.htmlreturns nothing — they sit one level deeper, incalculators/<name>/<name>_calculator.html.Checks
🤖 Generated with Claude Code
https://claude.ai/code/session_01MrvR2NXsJFVRCeJZFCPuNL
Generated by Claude Code