Repository navigation
docs: make knowledge base generic and refine header navigation - #8
Merged
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.
Public documentation audit and navigation refinement
This builds on the original header redesign and the request to make the complete public knowledge base general-purpose engineering education rather than employer-specific or interview preparation. It remains in PR #8; no changes are merged automatically.
Content audit scope and outcome
docs/guides/, across networking, Linux, Kubernetes, Terraform, GCP, GKE, cloud reliability and platform engineering.Interviewerto neutral engineering focus; removedQ1-style article headings andspoken answersections, replacing them with engineering problems and practical takeaways.follow-ups.mdURLs for link compatibility.docs/about.mdand the experience/biography sections ofdocs/index.mdremain intentionally personal, because those pages serve as the author's professional portfolio. The engineering guides do not narrate that experience.Automated regression prevention
scripts/audit-public-guides.mjsandnpm run docs:audit.npm run docs:build.Existing header change in this PR
Changed paths
docs/guides/(complete guide corpus).docs/index.md(one public-guide-description sentence only).docs/.vitepress/config.mts,docs/.vitepress/theme/custom.css.scripts/audit-public-guides.mjs(new).package.json..github/workflows/pr-build.yml.docs/about.mdor production deployment workflow.Verification
main; 100 total changed files.Expected site
https://edwinphilip.github.io/
Please review the changed guide tone and the header. Do not merge automatically.