Skip to content

PRDCT-372: split snowflake transformation page#988

Open
Iamfle4ka wants to merge 5 commits into
mainfrom
feat/PRDCT-372-snowflake-split
Open

PRDCT-372: split snowflake transformation page#988
Iamfle4ka wants to merge 5 commits into
mainfrom
feat/PRDCT-372-snowflake-split

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Closes PRDCT-372

Pilot of the Diátaxis split for a single page — the Snowflake transformation page. It validates the pattern, page template, and checklist now reused to split the whole Transformations section (PRDCT-376, stacked on this branch).

BEFORE → AFTER

  • Before: one page mixing why Snowflake (advantages), reference (limits, backend sizes, abort var, case-sensitivity, data-type casting, timestamps, read-only mapping), and a how-to ("Example") — a frankenstein.
  • After: a thin hub at the same URL → how-to (run one end-to-end + confirm + troubleshooting) · reference (all lookup material) · explanation (advantages + when/why). Old /transformations/snowflake/ still 301s to the hub.

Frontmatter & schema

Every page carries title, description, keywords, type (+ redirect_from on the hub). Schema extended with optional keywords + type.

Reusable artifacts

revamp/diataxis-page-template.md and revamp/diataxis-split-checklist.md for scaling to the rest of the section.

Human-review queue

Product facts that couldn't be verified against the component config schema (not in this repo) are flagged inline with TODO(human-review) — nothing invented or renamed: backend sizes + default, 7,200 s query timeout, 8,192-char comment segfault, ABORT_TRANSFORMATION semantics, AWS-US timestamp parameter overrides, copy/clone loading types, Free-Plan backend availability, and a few exact UI labels.

Verification

npm run build clean; the /transformations/snowflake/ → hub redirect and all cross-page anchors resolve; audit-phase2.mjs clean on the pilot pages.

Note: the page-type classification (Block 0) comes from the PRDCT-354 audit; audience / source-of-truth tags are content-derived pending that input.

🤖 Generated with Claude Code

Nikita and others added 5 commits June 24, 2026 18:42
Lets every revamped page declare the single reader need it serves
(how-to | reference | explanation) plus user-vocabulary keywords for search/RAG.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…nation

Splits the frankenstein Snowflake transformation page into three Diátaxis pages,
each serving one reader need. Product facts that could not be verified against
component code (no schema in this repo) are flagged inline with TODO(human-review).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Keeps the old /transformations/snowflake-plain/ URL serving a short hub and
preserves redirect_from: /transformations/snowflake/ (verified 301 → hub).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ready for Issue B (scaling the split to the remaining ~15 frankensteins).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@linear

linear Bot commented Jun 24, 2026

Copy link
Copy Markdown

PRDCT-372

@vercel

vercel Bot commented Jun 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
connection-docs Ready Ready Preview, Comment Jun 24, 2026 8:47pm

Request Review

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