G
generating-api-docs
Create comprehensive API documentation with examples, authentication guides, and SDKs.\nUse when creating comprehensive API documentation.\nTrigger with phrases like \
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Create comprehensive API documentation with examples, authentication guides, and SDKs.\nUse when creating comprehensive API documentation.\nTrigger with phrases like \
How to use
- Przygotuj specyfikację OpenAPI 3.0+ zawierającą opisy wszystkich operacji, parametrów oraz przykłady żądań i odpowiedzi dla każdego endpointu.
- Wczytaj specyfikację za pomocą funkcji Read i sprawdź kompletność dokumentacji — upewnij się, że każda operacja ma summary, description, opisy parametrów i co najmniej jeden przykład.
- Wzbogać specyfikację o szczegółowe opisy w formacie Markdown, dodając przewodniki wprowadzające, wyjaśnienia przepływu uwierzytelniania i dokumentację limitów szybkości w sekcji info.description lub rozszerzeniach x-documentation.
- Wygeneruj interaktywną dokumentację używając Redoc lub Stoplight Elements z funkcją "Try It", która pozwala użytkownikom wykonywać żądania bezpośrednio ze strony dokumentacji.
- Utwórz przykłady kodu dla każdego endpointu w wielu językach programowania, wykorzystując generator przykładów kodu.
- Wdróż wygenerowaną dokumentację na statycznym hostingu (GitHub Pages, Netlify, Vercel) z niestandardowym brandingiem, nawigacją wersjonowaną i wyszukiwaniem pełnotekstowym.