technical-docs

Umiejętność Claude'a do tworzenia i przeglądu dokumentacji technicznej dla SDK Sentry. Pomaga w pisaniu stron dokumentacji, szczególnie plików MDX w katalogu docs/platforms/. Skupia się na wyjaśnianiu "po co" przed "jak", organizuje treść wokół intencji deweloperów, a nie powierzchni API, i eliminuje redundantne przykłady kodu. Idealna do tworzenia jasnych instrukcji, które pokazują konkretne warunki wymagające danego podejścia.

1. Zainstaluj umiejętność w swoim środowisku Claude'a, wskazując repozytorium getsentry/sentry-docs i ścieżkę .claude/skills/technical-docs. 2. Otwórz plik dokumentacji MDX, który chcesz napisać lub edytować, zwłaszcza z katalogu docs/platforms/. 3. Opisz Claude'owi, jaką sekcję dokumentacji chcesz stworzyć, i podaj kontekst — na przykład "Potrzebuję sekcji o ręcznym przechwytywaniu błędów w Next.js Server Actions". 4. Claude zastosuje zasadę "Why then How" — najpierw wyjaśni, dlaczego deweloper potrzebuje tego podejścia, a dopiero potem pokaże kod. 5. Poproś Claude'a o przegląd istniejącej dokumentacji pod kątem redundantnych przykładów kodu — jeśli ten sam wzorzec pojawia się w kilku sekcjach, Claude skonsoliduje go w jedno miejsce z odwołaniami. 6. Wykorzystaj Claude'a do weryfikacji, że każda instrukcja wyjaśnia konkretny warunek lub scenariusz, w którym jest potrzebna, zamiast tylko pokazywać kod bez kontekstu.