Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/pr-build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ on:
branches: [main]
paths:
- 'docs/**'
- 'scripts/**'
- 'package.json'
- 'package-lock.json'
- '.github/workflows/pr-build.yml'
Expand All @@ -26,5 +27,7 @@ jobs:
node-version: '20'
- name: Install dependencies
run: npm install
- name: Audit public guide content
run: npm run docs:audit
- name: Build VitePress
run: npm run docs:build
23 changes: 13 additions & 10 deletions docs/.vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,12 @@ export default withMermaid(defineConfig({
siteTitle: 'Edwin Philip',
nav: [
{ text: 'Home', link: '/' },
{ text: 'About me', link: '/about' },
{ text: 'GitHub', link: 'https://github.com/EdwinPhilip' },
{ text: 'LinkedIn', link: 'https://www.linkedin.com/in/edwin-philip-sudo/' }
{ text: 'Guides', link: '/guides/' },
{ text: 'About me', link: '/about' }
],
socialLinks: [
{ icon: 'github', link: 'https://github.com/EdwinPhilip', ariaLabel: 'GitHub profile' },
{ icon: 'linkedin', link: 'https://www.linkedin.com/in/edwin-philip-sudo/', ariaLabel: 'LinkedIn profile' }
],
sidebar: {
'/guides/': [
Expand Down Expand Up @@ -51,7 +54,7 @@ export default withMermaid(defineConfig({
{ text: '7. Incident investigation', link: '/guides/linux-internals/q7' },
] },
{ text: 'Hands-on labs', link: '/guides/linux-internals/labs' },
{ text: '35 difficult follow-ups', link: '/guides/linux-internals/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/linux-internals/follow-ups' },
] },
{ text: 'Module 3 · Kubernetes Architecture', link: '/guides/kubernetes/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/kubernetes/' },
Expand All @@ -70,7 +73,7 @@ export default withMermaid(defineConfig({
{ text: '12. Upgrades and troubleshooting', link: '/guides/kubernetes/q12' },
] },
{ text: 'Hands-on labs', link: '/guides/kubernetes/labs' },
{ text: '42 difficult follow-ups', link: '/guides/kubernetes/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/kubernetes/follow-ups' },
] },
{ text: 'Module 4 · Terraform', link: '/guides/terraform/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/terraform/' },
Expand All @@ -89,7 +92,7 @@ export default withMermaid(defineConfig({
{ text: '12. Enterprise platform design', link: '/guides/terraform/q12' },
] },
{ text: 'Hands-on labs', link: '/guides/terraform/labs' },
{ text: '45 difficult follow-ups', link: '/guides/terraform/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/terraform/follow-ups' },
] },
{ text: 'Module 5 · Google Cloud', link: '/guides/gcp/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/gcp/' },
Expand All @@ -104,7 +107,7 @@ export default withMermaid(defineConfig({
{ text: '8. Architecture and recovery', link: '/guides/gcp/q8' },
] },
{ text: 'Hands-on labs', link: '/guides/gcp/labs' },
{ text: '40 challenging follow-ups', link: '/guides/gcp/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/gcp/follow-ups' },
] },
{ text: 'Module 6 · GKE Operations', link: '/guides/gke/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/gke/' },
Expand All @@ -119,7 +122,7 @@ export default withMermaid(defineConfig({
{ text: '8. Upgrades and incidents', link: '/guides/gke/q8' },
] },
{ text: 'Hands-on labs', link: '/guides/gke/labs' },
{ text: '40 challenging follow-ups', link: '/guides/gke/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/gke/follow-ups' },
] },
{ text: 'Module 7 · Cloud Reliability', link: '/guides/reliability/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/reliability/' },
Expand All @@ -134,7 +137,7 @@ export default withMermaid(defineConfig({
{ text: '8. Incident command and game days', link: '/guides/reliability/q8' },
] },
{ text: 'Seven hands-on labs', link: '/guides/reliability/labs' },
{ text: '40 difficult follow-ups', link: '/guides/reliability/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/reliability/follow-ups' },
] },
{ text: 'Module 8 · Platform Engineering', link: '/guides/platform-engineering/', collapsed: true, items: [
{ text: 'Overview', link: '/guides/platform-engineering/' },
Expand All @@ -149,7 +152,7 @@ export default withMermaid(defineConfig({
{ text: '8. Multi-cluster governance', link: '/guides/platform-engineering/q8' },
] },
{ text: 'Eight hands-on labs', link: '/guides/platform-engineering/labs' },
{ text: '40 difficult follow-ups', link: '/guides/platform-engineering/follow-ups' },
{ text: 'Advanced FAQs', link: '/guides/platform-engineering/follow-ups' },
] },
]
},
Expand Down
81 changes: 81 additions & 0 deletions docs/.vitepress/theme/custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,84 @@
.VPHome .VPHero .tagline { max-width: 760px; font-size: 18px; line-height: 1.6; }
.vp-doc blockquote { border-left-color: var(--vp-c-brand-1); }
.vp-doc table { display: table; width: 100%; }


/*
* Header navigation
*
* Keep three primary destinations in a compact, balanced pill. Let VitePress
* render GitHub and LinkedIn as accessible social icon links beside the theme
* toggle. Mobile continues to use VitePress's built-in navigation screen.
*/
@media (min-width: 960px) {
.VPNavBar .VPNavBarMenu {
display: flex;
align-items: center;
gap: 2px;
height: 44px;
margin-right: 10px;
padding: 4px;
border: 1px solid var(--vp-c-divider);
border-radius: 999px;
background: var(--vp-c-bg-soft);
}

.VPNavBar .VPNavBarMenuLink {
display: inline-flex;
align-items: center;
justify-content: center;
height: 34px;
padding: 0 15px;
border: 0;
border-radius: 999px;
white-space: nowrap;
transition: background-color 160ms ease, color 160ms ease;
}

.VPNavBar .VPNavBarMenuLink .text {
line-height: 34px;
font-weight: 500;
}

.VPNavBar .VPNavBarMenuLink:hover {
background: var(--vp-c-bg-elv);
}

.VPNavBar .VPNavBarMenuLink:hover .text,
.VPNavBar .VPNavBarMenuLink.active .text {
color: var(--vp-c-brand-1);
}

.VPNavBar .VPNavBarMenuLink.active {
background: var(--vp-c-brand-soft);
}

.VPNavBar .VPNavBarSocialLinks {
margin-left: 4px;
padding-left: 12px;
border-left: 1px solid var(--vp-c-divider);
}

.VPNavBar .VPNavBarSocialLinks a {
border-radius: 10px;
transition: background-color 160ms ease, color 160ms ease;
}

.VPNavBar .VPNavBarSocialLinks a:hover {
color: var(--vp-c-brand-1);
background: var(--vp-c-bg-soft);
}
}

.VPNavBar .VPNavBarMenuLink:focus-visible,
.VPNavBar .VPNavBarSocialLinks a:focus-visible {
outline: 2px solid var(--vp-c-brand-1);
outline-offset: 3px;
}

@media (prefers-reduced-motion: reduce) {
.VPNavBar .VPNavBarMenuLink,
.VPNavBar .VPNavBarSocialLinks a {
transition: none;
}
}
Loading
Loading