feat: Improve landing page for devops-basics site#787
Merged
Conversation
Add two new DevOps topics — OpenTofu (open-source Terraform fork) and HashiCorp Vault (secrets management) — each with README, basics hello-world script, and practice directory, following the existing topic structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Add new DevOps topic for Trivy (open-source vulnerability/security scanner) with README, basics demo script, and practice directory, following the existing topic structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Add new DevOps topic for Google Cloud Platform (GCP) with README, basics hello-world script, and practice directory, following the existing topic structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Add three issue templates — bug report, content improvement, and new topic request — to standardize contributor issue submissions. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Add mkdocs.yml config, requirements-docs.txt, and a deploy-docs GitHub Actions workflow to build and publish the documentation site. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
- Add Learning Paths section (5 role-based paths: Beginner, Platform Engineer, SRE, Cloud, DevSecOps) - Add 4 new topics to topics table: Vault, OpenTofu, Trivy, GCP - Update topic count from "30+" to "40+" - Highlight security-first capability (Vault, Trivy, Snyk, SonarQube) - Link to new ROADMAP.md from topics section - Add ROADMAP.md with upcoming topics, planned improvements, and learning paths Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Build a full-bleed hero home page using MkDocs Material overrides: - overrides/home.html: hero section with gradient/glow, animated stats bar, CTA buttons, feature cards, 8-category grid, learning trio, and final CTA - docs/stylesheets/extra.css: complete design system — CSS variables, hero layout, feature/category/trio cards, responsive breakpoints, hover effects - docs/javascripts/extra.js: live GitHub star count via API with animated counter on scroll into view - docs/index.md: home page frontmatter activating the custom template - mkdocs.yml: wired extra CSS/JS and home page to docs/index.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Phase 2 - Topic Cards Showcase: - Add topics/index.md with Material grid cards for all 40+ topics organized into 8 categories with icons, descriptions, and links - Wire as "All Topics" entry in nav Phase 3 - Visual Polish & Branding: - Switch palette from indigo to teal/cyan (modern tech feel) - Add Inter (text) and JetBrains Mono (code) fonts - Enhance Material grid card hover lift + teal border glow - Zebra-stripe tables, rounded admonitions, styled headings - Add copyright and footer to mkdocs.yml - Color-coded tag icons per category Phase 4 - Navigation & Search UX: - Add navigation.path (breadcrumbs) feature - Add navigation.indexes for section index pages - Add tags plugin with tags.md index page - Add tags/index page for browsing by category tag Phase 5 - Performance & SEO: - Add mkdocs-minify-plugin (HTML/JS/CSS compression) - Add --clean flag to gh-deploy to remove stale files - Add print media query to hide decorative sections - docs/index.md already has full Open Graph metadata (from Phase 1) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
Conflicts in README.md, mkdocs.yml, requirements-docs.txt, and deploy-docs.yml resolved by keeping the all-phases branch (HEAD) for every conflict: teal/cyan theme, Inter font, tags + minify plugins, navigation.path, --clean deploy with GA key, and the Vault/OpenTofu/ Trivy/GCP README rows from this branch. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0145wKykex72kkJtrFNarz9M
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.
feat: Improve landing page for devops-basics site