add website reference: /welcome PDF flow

Documents the unlisted /welcome route (meta-refresh → welcome.pdf,
browser's native PDF viewer renders it) and the one-line aws-cli
update procedure for the out-of-band PDF in Garage S3.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Donavan Fritz
2026-05-28 10:13:16 -05:00
parent 2a506f190a
commit 06b6b12947
2 changed files with 41 additions and 0 deletions
+7
View File
@@ -35,4 +35,11 @@ user-invocable: true
<reference file="reference/boat.md"
categories=["water"]
keywords=["boat", "dock, "launch"] />
</references>
<references>
<reference file="reference/website.md"
summary="Lodge website: site-publish flow, /welcome PDF redirect, out-of-band PDF update via aws-cli"
categories=["website"]
keywords=["website", "thelonglakelodge.com", "welcome packet", "PDF", "welcome.pdf", "/welcome", "Garage S3", "site-publish", "excludes"] />
</references>
+34
View File
@@ -0,0 +1,34 @@
# Lodge website
<overview>
Static site `www.thelonglakelodge.com` (apex → 301 → www). Source at
`~/code/git/code.fritzlab.net/websites/thelonglakelodge.com`. Published via
`action/site-publish@v1`: push to `main``aws s3 sync --delete` to Garage
bucket `thelonglakelodge.com`, ArgoCD reconciles Traefik Ingress + cert.
</overview>
<welcome-packet>
## Welcome packet PDF (`/welcome`)
URL `https://www.thelonglakelodge.com/welcome/` → meta-refresh + JS
`location.replace()``welcome.pdf` (browser's native PDF viewer renders
the file). Unlisted (`noindex,nofollow`), not in nav.
The PDF lives in Garage S3 **only**, NOT in git:
- S3 key: `s3://thelonglakelodge.com/welcome/welcome.pdf`
- Public URL: `https://www.thelonglakelodge.com/welcome/welcome.pdf`
- Preserved across site-publish runs via `excludes:` in `site.yaml`
(the `--exclude` flag was added to `action/site-publish` for this case).
### Update the packet
One command — change is live immediately, no git/CI involved:
```sh
aws --profile sjc001 s3 cp /path/to/new.pdf \
s3://thelonglakelodge.com/welcome/welcome.pdf \
--content-type application/pdf
```
The `sjc001` aws-cli profile is documented in fritzlab `garage.md`.
</welcome-packet>