Conversation
…E.md From the 2026-07-30 Jordan sync. These lived only in a call note, so sessions that never read it kept doing the thing Jordan objected to: placing migrated content at the first name-matching spot and adding it alongside the existing help page, which leaves duplicate overviews and redirect loops behind. Three rules: - De-duplicate, never add-alongside; search for where the concept already lives (including the hidden **/other/ nav subgroups) and unify into one canonical page. - Information architecture is a human call made against the live preview; automated audit output is evidence, not a verdict. Recommend and surface, don't self-place. - Never hard-delete a dev page without scanning what links to it. The 2026-08-03 scan found 210 files linking to /extend/component and 65 to /extend/common-interface across the keboola org alone. Related: #1000 (broader house-style/process pass on CLAUDE.md, still draft) and the .claude/skills/migration-placement skill this points at. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Iamfle4ka
changed the title
Collaborator
Author
|
Superseded by #1086, which consolidates the four PRs that were all editing Everything here survived: the Migrating dev docs into help section is in #1086 with all three rules intact. One fix applied — the inbound-link bullet pointed at Closing as a duplicate; the branch stays on the remote. |
This was referenced Aug 5, 2026
jordanrburger
pushed a commit
that referenced
this pull request
Aug 5, 2026
Consolidates four overlapping PRs that all edited the same three files: #1000 (docs house style + revamp process), #1065 (dev→help migration rules), #1057 and #1076 (Vercel-is-production, .claude symlink fix). Two conflicts are resolved by hand rather than by merge order: the Screenshots bullet, which #1000 and #1057 rewrote in different directions, and the Claude-specific notes list, where #1057 dropped three bullets #1000 kept. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This branch was successfully deployed
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
1 participant
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.
From the 2026-07-30 sync. These rules lived only in a call note, so sessions that never read it kept doing the thing you objected to — placing migrated content at the first name-matching spot and adding it alongside the existing help page, leaving duplicate overviews behind.
Three rules added under a new
## Migrating dev docs into helpheading:**/other/nav subgroups where thin stubs hide./extend/componentand 65 to/extend/common-interfaceacross thekeboolaorg alone — so "broken inbound links are acceptable" no longer holds for those sections.Docs-only, no build impact.
Related: #1000 (broader CLAUDE.md house-style pass, still draft) ·
.claude/skills/migration-placement/(the skill these rules point at).🤖 Generated with Claude Code