Skip to content

docs: Full Knowledge Base Overhaul #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
alongir wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

docs: Full Knowledge Base Overhaul #40

alongir wants to merge 1 commit into from

Conversation

@alongir
Copy link
Member

@alongir alongir commented Jan 30, 2026

Summary

Complete documentation overhaul to transform the Kubeshark docs into a professional knowledge base with improved navigation, better content organization, and v2.00 messaging alignment.

Key Changes

  • Introduction rewrite: Use-case first approach highlighting incident investigation, performance optimization, security analysis, and continuous monitoring
  • Navigation reorganization: Logical sidebar structure (Getting Started, Core Features, Traffic Analysis, Automation, Integrations, etc.)
  • Professional styling: Callout boxes (info, tip, warning, danger), feature cards, badges, improved tables and code blocks
  • New pages: Quick Start (60-second installation), enhanced Protocols page
  • Brand consistency: Ubuntu font (matching kubeshark.com), updated code block colors, Kubeshark links throughout
  • Bug fixes: Fixed domain references (kubeshark.co → kubeshark.com), replaced K8s with Kubernetes

Files Changed

Category Files
Content introduction.md, protocols.md, quick_start.md (new), 80+ content pages
Styling theme.css, index.css
Components Breadcrumb.astro (new), LeftSidebar.astro, HeadCommon.astro
Config config.ts (sidebar + SEO)

Test plan

  • Review introduction page messaging
  • Verify sidebar navigation works correctly
  • Check callout styling in various pages
  • Test dark mode appearance
  • Verify code block styling matches kubeshark.com
  • Check all Kubeshark links resolve correctly

🤖 Generated with Claude Code

@vercel
Copy link

vercel bot commented Jan 30, 2026 •
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jan 30, 2026 9:49am

Request Review

@alongir alongir force-pushed the docs/knowledge-base-overhaul branch from 888940b to 9ce943f Compare January 30, 2026 09:48
docs: Full knowledge base overhaul
4982876 
- Rewrite introduction with use-case first approach and v2.00 messaging
- Reorganize sidebar navigation into logical sections
- Add professional styling (callouts, cards, badges, improved tables)
- Create breadcrumb navigation component
- Add quick_start.md for 60-second installation guide
- Enhance protocols page with full protocol details
- Update fonts to Ubuntu (matching kubeshark.com)
- Update code blocks styling to match main site
- Add Kubeshark links throughout content
- Replace K8s references with Kubernetes
- Fix domain from kubeshark.co to kubeshark.com
- Fix SEO/OG configuration
@alongir alongir force-pushed the docs/knowledge-base-overhaul branch from 9ce943f to 4982876 Compare January 30, 2026 09:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@alongir