Investigate and Debug Issue #76
Open
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
Investigated why "Build documentation" succeeds on PRs but fails on main. Root cause: - PR #75 fixed the Notion fetch scripts to quote YAML special characters - BUT the content branch still contains old files with unquoted frontmatter - PRs regenerate content (using fixed scripts) → success ✅ - Main uses existing content branch → failure ❌ Solution: - Created automated fix script (scripts/fix-yaml-frontmatter.ts) - Identified 10 files needing fixes in content branch - All have unquoted colons (:) and ampersands (&) in titles Files added: - INVESTIGATION-REPORT.md: Detailed analysis and recommendations - SOLUTION.md: Step-by-step fix instructions - scripts/fix-yaml-frontmatter.ts: Automated YAML frontmatter validator/fixer Next steps: 1. Apply fix script to content branch 2. Commit and push changes to content branch 3. Verify main branch build succeeds Related: PR #75, main branch build failures
Contributor
🚀 Preview DeploymentYour documentation preview is ready! Preview URL: https://pr-76.comapeo-docs.pages.dev 🔄 Content: Regenerated 5 pages from Notion (content branch was empty, used fallback)
This preview will update automatically when you push new commits to this PR. Built with commit c105058 |
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.
Investigated why "Build documentation" succeeds on PRs but fails on main.
Root cause:
Solution:
Files added:
Next steps:
Related: PR #75, main branch build failures