Skip to content

Remove generated HTML and dead Windows build tooling - #49

Merged
t4k merged 1 commit into
caltechlibrary:mainfrom
t4k:cleanup/remove-orphaned-build-output
Sep 2, 2026
Merged

Remove generated HTML and dead Windows build tooling#49
t4k merged 1 commit into
caltechlibrary:mainfrom
t4k:cleanup/remove-orphaned-build-output

Conversation

@t4k

@t4k t4k commented Sep 2, 2026

Copy link
Copy Markdown
Member

Purely subtractive: 33 files, −3968 lines, nothing added but a one-line doc fix.

The 28 HTML files

They became orphaned when #46 moved the docs build to assemble from docs/
instead of filtering the repository root. Verified before deleting:

  • No file that stays references any of them.
  • build-pandoc globs docs/*.md plus extra-sources: "*.md". HTML is
    neither an input nor read from the root.
  • The two pages that matter are generated, not committed. README.md becomes
    index.html via the action’\s --index-from default, and docs/search.md
    becomes search.html.

20 are in the root, 8 in llm_notes/. The llm_notes/*.md sources stay.

make.ps1 and .nojekyll

make.ps1 is the last of its family — website.ps1 and website.mak are
already gone. .nojekyll was for branch-based Pages; deployment is
artifact-based (actions/deploy-pages@v5), so Jekyll never runs.

INSTALL_NOTES_macOS.md, INSTALL_NOTES_Windows.md

They document bypassing Gatekeeper and SmartScreen for unsigned executables.
This repository ships browser JavaScript and has no executables. cmt already
excludes both from --init for deno-webcomponent projects, so removing them
applies its design rather than diverging from it. Nothing links to them;
ADR-0003 mentions them in prose describing the layout at the time.

One documentation edit

docs/building_web_components_with_deno.md had a PowerShell block invoking the
deleted make.ps1. Removed.

The rest of that section is still stale and is deliberately not touched
here — it teaches make website, which has been broken since website.mak
was removed, and contains two typos (web release, ./replace.bash). That
belongs with the documentation rewrite, not this deletion.

Not in this change

The 11 committed JS bundles in the root. Those are still what the S3 copy
serves, so they wait until publishing comes from dist/.

The 28 committed HTML files became orphaned when caltechlibrary#46 moved the docs build
to assemble from docs/ rather than filtering the repository root. Nothing
reads them: no kept file links to any of them, and the build globs only
Markdown. Both pages that matter are generated -- README.md becomes
index.html via build-pandoc's --index-from default, and docs/search.md
becomes search.html.

make.ps1 goes with website.ps1 and website.mak, already removed. .nojekyll
was for branch-based Pages; deployment is artifact-based now, so Jekyll
never runs.

INSTALL_NOTES_macOS.md and INSTALL_NOTES_Windows.md document bypassing
Gatekeeper and SmartScreen for unsigned executables. This repository ships
browser JavaScript and has no executables. cmt already excludes both from
--init for deno-webcomponent projects, so removing them applies its design
rather than diverging from it.

Also drops the PowerShell block in docs/building_web_components_with_deno.md,
which invoked the deleted make.ps1.
@t4k
t4k merged commit 989cece into caltechlibrary:main Sep 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant