Zum Hauptinhalt springen
Dieser Inhalt ist noch nicht in Ihrer Sprache verfügbar und wird auf Englisch angezeigt.

API Docs

Skill Verifiziert Aktiv
Teil von:Ruflo Docs

Generate API documentation from source code with JSDoc and OpenAPI support

Zweck

To automate the generation and maintenance of API documentation, ensuring consistency and completeness for developers using JSDoc and OpenAPI standards.

Funktionen

  • Generate API documentation from source code
  • Support for JSDoc annotations (@param, @returns, @throws, @example)
  • Automatic generation of missing JSDoc comments
  • Generate OpenAPI 3.0 specifications for HTTP endpoints

Anwendungsfälle

  • Automatically document new API endpoints or functions
  • Ensure all public APIs have JSDoc comments with types and descriptions
  • Maintain a consistent OpenAPI specification alongside source code
  • Generate documentation for codebases written in TypeScript and JavaScript

Nicht-Ziele

  • Generating documentation for languages other than TypeScript/JavaScript
  • Creating UI documentation or user guides
  • Performing runtime analysis of API behavior

Workflow

  1. Scan source code for public exports
  2. Extract JSDoc annotations
  3. Generate missing JSDoc comments
  4. Generate OpenAPI 3.0 specification for HTTP endpoints

Praktiken

  • Documentation Generation
  • API Specification

Voraussetzungen

  • Node.js environment
  • Source code with JSDoc comments (recommended)

Installation

Zuerst Marketplace hinzufügen

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-docs@ruflo

Qualitätspunktzahl

Verifiziert
99 /100
Analysiert about 22 hours ago

Vertrauenssignale

Letzter Commitabout 24 hours ago
Sterne50.2k
LizenzMIT
Status
Quellcode ansehen

Ähnliche Erweiterungen

Deepinit

100

Deep codebase initialization with hierarchical AGENTS.md documentation

Skill
Yeachan-Heo

Cleanup Cycles

100

Detect and untangle circular dependencies. Runs madge/skott (TS), pycycle (Py), or compiler-only checks (Go/Rust). Auto-fixes leaf-extractable cycles; reports core cycles for human review. Use when the user asks to find circular imports, fix dependency cycles, or untangle module graph. Example queries — "find circular imports", "fix dependency cycles", "untangle our module graph", "why is madge complaining".

Skill
raintree-technology

Netlify Identity

100

Verwenden Sie dies, wenn die Aufgabe Authentifizierung, Benutzerregistrierungen, Anmeldungen, Passwortwiederherstellung, OAuth-Anbieter, rollenbasierte Zugriffskontrolle oder den Schutz von Routen und Funktionen beinhaltet. Verwenden Sie immer `@netlify/identity`. Verwenden Sie niemals `netlify-identity-widget` oder `gotrue-js` – diese sind veraltet.

Skill
netlify

Vue Router Best Practices

100

Vue Router 4 patterns, navigation guards, route params, and route-component lifecycle interactions.

Skill
hyf0

Sentry React Router Framework Sdk

100

Full Sentry SDK setup for React Router Framework mode. Use when asked to "add Sentry to React Router Framework", "install @sentry/react-router", or configure error monitoring, tracing, profiling, session replay, logs, or user feedback for a React Router v7 framework app.

Skill
getsentry

Code Documenter

99

Generates, formats, and validates technical documentation — including docstrings, OpenAPI/Swagger specs, JSDoc annotations, doc portals, and user guides. Use when adding docstrings to functions or classes, creating API documentation, building documentation sites, or writing tutorials and user guides. Invoke for OpenAPI/Swagger specs, JSDoc, doc portals, getting started guides.

Skill
jeffallan