documentation-templates
Szablony dokumentacji i wytyczne struktury dla projektów AI-friendly
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Zestaw gotowych szablonów dokumentacji ułatwiających tworzenie README, dokumentacji API, komentarzy kodu i materiałów przyjaznych dla modeli AI. Zawiera struktury dla najczęstszych typów dokumentacji z przykładami i najlepszymi praktykami. Idealne do standaryzacji dokumentacji w projektach i zespołach.
Jak używać
Zainstaluj skill w swoim projekcie, korzystając z dostarczonego repozytorium. Skill wykorzystuje narzędzia Read, Glob i Grep do pracy z plikami dokumentacji.
Dla nowego projektu zacznij od szablonu README. Wypełnij obowiązkowe sekcje w kolejności: tytuł z jednolinijkowym opisem, Quick Start (uruchomienie w poniżej 5 minut), Features, Configuration, linki do dokumentacji API i Contributing.
Dokumentuj każdy endpoint API, używając szablonu per-endpoint. Dla każdego endpointu określ metodę HTTP i ścieżkę, dodaj parametry w tabeli (nazwa, typ, wymagalność, opis), wymień możliwe kody odpowiedzi (np. 200, 404) i dołącz przykład request-response.
W kodzie źródłowym stosuj szablon JSDoc/TSDoc dla funkcji i metod. Każdy blok komentarza powinien zawierać krótki opis, parametry (@param), wartość zwracaną (@returns), wyjątki (@throws) i przykład użycia (@example).
Pamiętaj o regule komentowania: opisuj "dlaczego" (logika biznesowa), a nie "co" (oczywiste rzeczy). Komentuj złożone algorytmy i nieoczywiste zachowania, ale unikaj komentowania każdej linii czy oczywistego kodu.
Przechowuj szczegółową dokumentację w osobnych plikach (np. docs/api.md, docs/architecture.md) i linkuj do nich z README, aby utrzymać przejrzystość i strukturę.