Improve v7.1.2 docs to reduce conflicts with PR #7#8
Open
sensei-hacker wants to merge 12 commits intomasterfrom
Open
Improve v7.1.2 docs to reduce conflicts with PR #7#8sensei-hacker wants to merge 12 commits intomasterfrom
sensei-hacker wants to merge 12 commits intomasterfrom
Conversation
Improved tool output to reduce conflicts with the manually-converted docs in #7: - Fix editUrl branch: tree/main → tree/master (repo uses master) - Normalize anchor fragments to lowercase (e.g. #Nav-Poshold → #nav-poshold) - Collapse double hyphens in relative link paths (GPS--and → GPS-and) - Rewrite wiki assets/ and images/ paths to /img/content/ - Normalize all-caps front matter titles to title case (TROUBLESHOOTING → Troubleshooting) - Fix relative .md links whose filenames have special chars (colons, commas) via normalized page-mapping lookup - Sanitize parentheses from output filenames: Lightweight-Telemetry-(LTM) → Lightweight-Telemetry-LTM (parens break markdown link syntax) - Run a second link-rewrite pass using versioned output as the mapping source to fix any remaining cross-category links - Move GPS-and-Compass-setup to quickstart/ (matches category mapping) - Combine individual release note files into a single tabbed Release-Notes.md (drops 7.0.0-Release-Notes.md and 7.1.0-Release-Notes.md)
Fixes [INAV Wiki](https://github.com/.../wiki/Lightweight-Telemetry-(LTM)) being rewritten to ...LTM.md)) with an extra closing paren. The URL capture regex now allows one level of balanced parens so the outer markdown link-close ) is correctly identified.
Rebuilt from updated wiki commit that includes: - Sensor-calibration → Calibration-Tab link fixes - servo-autotrim → servo-autotrim-fw anchor fixes - autotune → autotune-fw anchor fixes - setting-up-failsafe-with-return-to-home → setting-up-failsafe-for-rth - New-features-over-versions-log → Older-Release-Notes - MSP arming blocker URL /_edit suffix removed - Skyhunter heading simplified (version qualifier removed)
…d Calibration-Tab to quickstart
…ckstart placement
… self-page links, MSP V2 title
…self-page anchors, MSP V2 title
…heading validation
Member
Author
|
This is basically the same as #7 , with the merge conflicts fixed. |
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.
Summary
This PR regenerates the INAV v7.1.2 versioned docs with an improved conversion tool, specifically to reduce the number of conflicts with the manually-converted docs in (#7).
If this is merged first, there should be fewer merge conflicts.
Changes from the previous generated docs
tree/main→tree/master(this repo usesmaster)#Nav-Poshold→#nav-poshold(Docusaurus anchors are lowercase)GPS--and-Compass→GPS-and-Compassin relative linksassets/andimages/paths rewritten to/img/content/TROUBLESHOOTING→Troubleshooting)Lightweight-Telemetry-(LTM).md→Lightweight-Telemetry-LTM.md(parens in filenames break markdown link syntax)quickstart/(matches category mapping); Navigation-Mode:-Return-to-Home moved tofeatures/7.0.0-Release-Notes.mdand7.1.0-Release-Notes.mdmerged into a single tabbedRelease-Notes.mdRemaining known broken links (11 total)
These are unavoidable without a rename map — the wiki renamed pages between versions:
Sensor-calibration.md→ wiki renamed toCalibration-Tab.md(9 links)New-features-over-versions-log.md→ wiki renamed toOlder-Release-Notes.md(2 links)These produce
onBrokenLinks: "warn"warnings, not build errors.Test plan
npm run buildsucceeds in the docs site