{"adoption": {"forks": 843, "observed_at": "2026-08-28T04:08:24.185980+00:00", "stars": 3847}, "canonical_url": "https://ross.abutalabs.com/products/raml-spec", "card": {"archived": true, "artifact_type": "learning-resource", "description": "RAML Specification", "domain": ["apis", "web-development", "documentation", "developer-tools"], "enriched": true, "function": ["api-documentation", "documentation", "serialization"], "health_score": 10, "homepage": "http://raml.org", "language": null, "license": null, "license_family": "other", "maturity": "maintenance", "member_repos": ["raml-org/raml-spec"], "name": "raml-org/raml-spec", "platform": ["cross-platform"], "pushed_at": "2022-03-25T21:55:39+00:00", "repo": "raml-org/raml-spec", "stars": 3847, "tags": ["raml", "api-specification", "rest", "yaml", "api-design", "specification", "contract-first"], "topics": ["raml", "api-documentation", "api-definition", "raml-specification"], "urls": [], "use_cases": ["define a REST API contract in a readable YAML format", "generate API documentation from a spec", "generate client and server code stubs from an API definition", "mock an API before implementation", "learn how to write RAML 1.0 API definitions", "model reusable types and schemas for an API"], "what_it_is": "The official specification for RAML (RESTful API Modeling Language), a YAML-based language for describing practically-RESTful HTTP APIs in a human- and machine-readable format. This repository hosts the RAML 1.0 spec document, which defines how to model resources, methods, parameters, types, and responses to enable code generation, mocking, testing, and documentation.", "when_to_avoid": ["you need a spec with broad current tooling adoption and active ecosystem momentum (OpenAPI is more widely supported)", "you need a runnable library or tool rather than a specification document", "you are building non-REST or event-driven APIs"], "when_to_choose": ["you want a human-readable, YAML-based alternative to OpenAPI for designing REST APIs", "you follow a design-first workflow and need a formal versioned API contract", "you need to generate docs, mocks, or code from a single API definition"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/raml-spec", "repo": "raml-org/raml-spec", "role": "main", "score": 10}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "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:08:24.185980+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:08:24.185980+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T18:26:00.573772+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "380a3a7d1df777046d1defe6c10f9b9b22fcf64a9e21cfcbc8715ae52a16ac3f", "fetched_at": "2026-08-28T04:08:24.185980+00:00", "kind": "readme", "missing": false, "url": "https://github.com/raml-org/raml-spec"}, {"content_hash": "cbc0a42e03aba5ef9ba74cadde1d78e122f8f34dfb5f5e2309686a4ef75e6ec7", "fetched_at": "2026-08-29T09:21:11.700049+00:00", "kind": "homepage", "missing": false, "url": "http://raml.org"}, {"content_hash": "21df721e2f26b77904586677e83268aa3f3c0a04c718e3a9c914ee59ed9cf792", "fetched_at": "2026-08-29T09:21:11.709457+00:00", "kind": "site_page", "missing": false, "url": "https://raml.org/about-raml"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 0, "longevity": 100, "rhythm": 8}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["archived", "no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 4720, "days_push": 1622, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 10, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}