{"adoption": {"forks": 228, "observed_at": "2026-08-28T04:05:36.418264+00:00", "stars": 1788}, "canonical_url": "https://ross.abutalabs.com/products/swagger-jsdoc", "card": {"archived": false, "artifact_type": "library", "description": "Generates swagger/openapi specification based on jsDoc comments and YAML files.", "domain": ["apis", "documentation", "web-development", "developer-tools"], "enriched": true, "function": ["api-documentation", "documentation", "parser", "developer-tools"], "health_score": 98, "homepage": null, "language": "JavaScript", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["Surnet/swagger-jsdoc"], "name": "Surnet/swagger-jsdoc", "platform": [], "pushed_at": "2026-08-23T17:04:07+00:00", "repo": "Surnet/swagger-jsdoc", "stars": 1788, "tags": ["openapi", "swagger", "jsdoc", "api-specification", "code-generation", "nodejs", "javascript"], "topics": ["swagger", "jsdoc", "swagger-jsdoc", "openapi"], "urls": [], "use_cases": ["generate openapi spec from jsdoc comments", "document express api routes with swagger annotations", "keep api docs in sync with code", "validate swagger docs in unit tests", "generate openapi 3.0 specification from yaml files", "document nodejs rest api"], "what_it_is": "A Node.js library that reads JSDoc-annotated source code and YAML files to generate OpenAPI (Swagger) specifications. It supports OpenAPI 3.x, Swagger 2, and AsyncAPI 2.0, with optional validation that throws on parsing errors.", "when_to_avoid": ["you want to write OpenAPI specs by hand without code annotations", "your project is not JavaScript/Node.js based", "you need spec generation from other sources like TypeScript types or runtime request inspection"], "when_to_choose": ["you want API documentation defined inline next to route handlers as JSDoc comments", "you need a validated OpenAPI/Swagger/AsyncAPI spec generated at build or runtime in Node.js", "you prefer documenting APIs in YAML blocks within source files"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/swagger-jsdoc", "repo": "Surnet/swagger-jsdoc", "role": "main", "score": 83}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:05:36.418264+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T03:23:20.057192+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "e3cae7aa49c7f0e954e1df65fd7a5567982d9599b21ff49bc4e056a1c93ea6b3", "fetched_at": "2026-08-28T04:05:36.418264+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Surnet/swagger-jsdoc"}, {"content_hash": "d1d1da341538ca77790d0a9fcf632fe655e5fd090491fccedef5a51c0bd89e3f", "fetched_at": "2026-08-29T11:02:34.018440+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/swagger-jsdoc"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 99, "longevity": 100, "rhythm": 53}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 4106, "days_push": 10, "days_rel": 103, "gap_med": null, "n_releases_24m": 1}, "score": 83, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}