Technical Documentation and Knowledge Sharing Questions

# Record state
hostname=$(hostname); echo "Host: $hostname"; sudo systemctl status my-service --no-pager

# Restart service
sudo systemctl restart my-service
sleep 5

# Verify service active
if ! sudo systemctl is-active --quiet my-service; then
  echo "Service failed to start"; sudo journalctl -u my-service -n 200 --no-pager | tail -n 50
  exit 2
fi

# HTTP health check (expect 200 and JSON containing "status":"ok")
status_code=$(curl -sS -o /tmp/health.json -w "%{http_code}" http://127.0.0.1:8080/health)
if [ "$status_code" != "200" ]; then
  echo "Health endpoint returned $status_code"
  cat /tmp/health.json
  sudo journalctl -u my-service -n 200 --no-pager | tail -n 100
  exit 3
fi

grep -q '"status":"ok"' /tmp/health.json && echo "Service healthy" || (cat /tmp/health.json; exit 4)

#!/usr/bin/env python3
import os, re, pathlib

ROOT = '.'  # repo root
OUT = 'TOC.md'
IGNORED = {'node_modules', '.git'}
header_re = re.compile(r'^(#{1,3})\s+(.*)')

def extract_headers(path):
    headers = []
    in_fence = False
    with open(path, encoding='utf-8') as f:
        for line in f:
            line = line.rstrip('\n')
            if line.strip().startswith('

Key points:
- Skips fenced code blocks by toggling on