Documentation
Welcome to the documentation. Here you'll find guides, tutorials, and reference materials.
Why this Bazel reference exists
Why I used the OpenTelemetry Astronomy Shop as a serious Bazel learning lab, what changed in the migration, and which services make this repo a deep polyglot reference.
Repository guide and how to follow the docs
How to use the Bazel migration fork repository, where to start in the documentation, and the exact reading path to move from strategy to implementation.
Patterns I would reuse in any Bazel migration
A professional recap of the migration patterns that proved durable: milestone slicing, dual-build policy, CI tag routing, lockfile discipline, and runfiles-aware testing.
Introduction
Introduction to the Vendor Agnostic Surveillance project - A real-world case study of building a cloud-controlled video platform for distributed IP cameras
Kerberos Agent Deployment
Deploying Kerberos Agent on the edge node to process video streams from Dahua cameras
Lab Setup
Setting up a local lab environment to simulate the Vendor Agnostic Surveillance architecture using Multipass VMs and Tailscale VPN
Collecting GitHub Actions Traces with OpenTelemetry and SigNoz
Setting up observability for GitHub Actions workflows using OpenTelemetry Collector and SigNoz to track traces and metrics.
Opentelemetry demo app with SigNoz integration
Learning SigNoz APM features by deploying a fully instrumented microservice application (OpenTelemetry demo app).
Auto-instrumentation with SigNoz
Instrumenting applications with SigNoz using OpenTelemetry auto-instrumentation on Kubernetes.
k3smp
Provision production-like K3s clusters locally using real virtual machines with Multipass.
Caching
Understanding caching in system design and when to use it.
Databases
Picking the right database in system design and understanding different types.
Load Balancers
Understanding load balancers in system design and when to use them.
Availability Patterns
Let's talk about availability patterns of system design.
Background Jobs
Understanding background jobs in system design and when to use them.
Content Delivery Networks
Understanding content delivery networks in system design and when to use them.
Key Concepts
Let's talk about key concepts of system design.
Branching
Let’s talk about what Git branching really is, and how to work with it properly.
Repository
Let’s talk about what a Git repository really is, and how to work with it properly.
Git
Let’s talk about Git and why version control really matters.
Github
Let's talk about Github and how to use it for CI/CD.
Overview
Let's talk about system design and how to approach it step by step.
Linux Learning Overview
A complete learning path to understand, use, and master Linux systems from fundamentals to real-world operations.
test
A complete learning path to understand, use, and master Linux systems from fundamentals to real-world operations.
Documentation Guide
Complete guide to using all features and adding content to your portfolio website
Knowledge Base
Comprehensive knowledge base covering foundations, platforms, projects, architectures, and more
Adding Blog Posts
Complete guide to adding blog posts with examples
Adding Documentation
Complete guide to adding documentation with examples
Adding Content Overview
Overview of how to add documentation and blog posts
Footer
How to update footer content and links
Homepage
How to customize the homepage content and layout
Site Metadata
How to update site metadata and SEO
Navigation
How to update navigation items and links
Customization Overview
Overview of customization options for your portfolio website
Documentation Ordering System
Complete guide to controlling the order of sections, subsections, and documents
Colors & Styling
How to customize colors, fonts, and overall appearance
Deploy to Netlify
Step-by-step guide to deploying to Netlify
Deployment Overview
Overview of deployment options for your portfolio website
Static Export
How to deploy as a static site
Deploy to Vercel
Step-by-step guide to deploying to Vercel
Callout Components
Complete guide to using callout components with all types and examples
Code Blocks
Complete guide to enhanced code blocks with syntax highlighting
Excalidraw Diagrams
Complete guide to embedding interactive Excalidraw diagrams
Hero Image & Video
Add a full-width hero image or video at the top of any document or blog post to catch the reader's attention
Highlight Marker
Interactive text highlighting that activates when readers reach specific sections
Images & Videos
Complete guide to displaying images and videos with enhanced features
Mermaid Diagrams
Complete guide to creating and embedding Mermaid diagrams in your documentation
Metadata Card
Display author, read time, last updated, and tags in a sidebar card
Features Overview
Overview of all available features in your portfolio website
Global Search
Complete guide to the global search functionality
Tabbed Content
Complete guide to creating tabbed content sections
Table of Contents
Complete guide to the auto-generated table of contents
Terminal Component
Interactive terminal simulation with auto-typing commands and outputs
Creating Your First Document
Step-by-step guide to creating your first documentation page
Getting Started
Quick start guide and basic concepts for your portfolio website
Understanding Documentation Structure
Learn how the documentation structure works with sections, subsections, and documents
Troubleshooting
Common issues and solutions when working with your portfolio website
CI/CD
Continuous integration and deployment - concepts, tools, and implementations
Architectures
Design patterns, tradeoffs, and architectural decisions
Cloud
Provider-specific deep dives - AWS, GCP, Azure, and more
Foundations
Core concepts and vendor-neutral knowledge - learn once, reuse forever
Notes & Deep Dives
Thinking out loud - comparisons, insights, and deep technical explorations
Platforms
How to run Kubernetes and infrastructure - real setups, commands, and gotchas
Projects
Real-world use cases with complete implementations
Toolbox
Quick references, cheatsheets, and snippets for fast lookup
Initial APM setup with SigNoz
Bootstrapping a test Kubernetes cluster and deploying SigNoz for APM and infrastructure observability.