fix: restore lychee self-reference checks + docs site link in README: https://github.com/riboseinc/claude-memory-files/issues/1 - #16
Merged
Conversation
Two changes that piggyback on D3's deploy now being live. README: Adds a prominent docs-site link near the top, pointing at https://riboseinc.github.io/claude-memory-files/ with a one-line inventory of what's there (getting started, concepts, guides, reference, roadmap). lychee CI: Removes the three self-reference exclude patterns from lychee.toml (riboseinc.github.io/*, github.com/.../tree|blob/main/docs/*). They were added in PR 15 because the live site and main hadn't caught up with D3's pages at PR validation time. Now that D3 has merged and GH Pages is deployed, both resolve, so the excludes can come off and lychee actively verifies them. To make the resolution work cleanly, validate-docs now builds with the production baseurl into _lychee_site/claude-memory-files/ (mirroring the URL structure on disk). Root-relative links like /claude-memory-files/concepts/scope-rubric/ then resolve via --root-dir docs/_lychee_site to docs/_lychee_site/claude-memory-files/ concepts/scope-rubric/index.html — without needing any lychee remap. The previous --baseurl '' workaround caused canonicals to diverge from the live site (forcing the broadened exclude); the new layout makes both internal links AND canonical URLs check cleanly against the live site. .gitignore picks up docs/_lychee_site/ alongside docs/_site/. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.
Post-v1 follow-up. Two changes that piggyback on D3's GH Pages deploy now being live.
What this adds
README: prominent docs-site link near the top, pointing at https://riboseinc.github.io/claude-memory-files/ with a one-line inventory of what's there.
Restored lychee self-reference checks in
lychee.toml— removes the three exclude patterns (^https://riboseinc.github.io/,.../tree/main/docs/,.../blob/main/docs/). They were added in PR #15 because the live site andmainhadn't caught up with D3's pages at PR-validation time. Both resolve now.Mirrored-baseurl build path to make resolution work cleanly without lychee remap.
validate-docsnow builds with the production baseurl into_lychee_site/claude-memory-files/(filesystem layout mirrors URL structure). Root-relative links like/claude-memory-files/concepts/scope-rubric/resolve via--root-dir docs/_lychee_sitetodocs/_lychee_site/claude-memory-files/concepts/scope-rubric/index.html. The previous--baseurl ""workaround caused canonical URLs to diverge from the live site, which forced the broadened exclude — the new layout makes both internal links AND canonical URLs check cleanly against the live deployment.Verified locally
bundle exec jekyll build --destination _lychee_site/claude-memory-filesproduces the mirrored layout.curl -I https://riboseinc.github.io/claude-memory-files/concepts/scope-rubric/returns 200;github.com/.../tree/main/docs/roadmap/v1.adocreturns 301 (accepted via lychee.toml).🤖 Generated with Claude Code