Fix documentation 404s and generate static redirects - #587
Merged
Conversation
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
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.
Google's 404 report exposed 19 internal links pointing to 17 missing documentation destinations. Correct those links across 13 pages using root-relative paths, including the MQTT setup links, cellular container links, PWM LED paths, and malformed tasks link.
Make
static/redirects.yamleffective on the current GitHub Pages deployment by generating 28 standalone HTML redirect pages and registering both trailing-slash variants with Gatsby. Direct visits use an immediate meta refresh with a canonical URL; JavaScript preserves query strings and fragments. These are HTML redirects, not HTTP 301 responses. Retired Toit v1 pages without a clear replacement remain 404.Add
yarn check:linksto the production build so missing internal destinations fail the build. The check uses Python 3 and inspects generated HTML without network access; external links and fragment identifiers are excluded. Redirect validation rejects existing-page collisions, missing targets, and redirect chains.Validation:
yarn check:linkspasses for all 139 HTML files.yarn lintpasses.yarn test --runInBandpasses: 3 suites, 10 tests.