{"id":22486780,"url":"https://github.com/dan-q/well-known-feeds","last_synced_at":"2026-01-07T03:47:26.367Z","repository":{"id":265797101,"uuid":"682030389","full_name":"Dan-Q/well-known-feeds","owner":"Dan-Q","description":"Specification for the .well-known/feeds resource identifier","archived":false,"fork":false,"pushed_at":"2023-08-23T12:45:42.000Z","size":5,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T05:13:00.678Z","etag":null,"topics":["feeds","opml","well-known","well-known-uri"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dan-Q.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-23T09:35:15.000Z","updated_at":"2024-07-23T11:36:50.000Z","dependencies_parsed_at":"2024-12-01T01:02:40.867Z","dependency_job_id":null,"html_url":"https://github.com/Dan-Q/well-known-feeds","commit_stats":null,"previous_names":["dan-q/well-known-feeds"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dan-Q%2Fwell-known-feeds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dan-Q%2Fwell-known-feeds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dan-Q%2Fwell-known-feeds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dan-Q%2Fwell-known-feeds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dan-Q","download_url":"https://codeload.github.com/Dan-Q/well-known-feeds/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245915828,"owners_count":20693379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["feeds","opml","well-known","well-known-uri"],"created_at":"2024-12-06T17:15:22.003Z","updated_at":"2026-01-07T03:47:26.301Z","avatar_url":"https://github.com/Dan-Q.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# `.well-known/feeds` resource identifier\n\nThis document describes the use of URIs whose path component is `/.well-known/feeds`.\n\n## Registration\n\nInformation required by RFC5785:\n\n```\nURI suffix: feeds\nChange controller: Dan Q \u003chttps://danq.me/\u003e\nSpecification document(s): https://github.com/Dan-Q/well-known-feeds\nStatus: provisional\nRelated information: OPML 2.0 specification \u003chttp://opml.org/spec2.opml\u003e\n```\n\n## Representation\n\nThe `feeds` well-known resource endpoint provides an OPML document of any valid OPML version. That OPML document's `\u003cbody\u003e` is expected to contain one or more `\u003coutline\u003e` elements, referencing some or all of the feeds published by or representative of the website. This might include for example outlines of `type=\"rss\"` referring to feeds themselves, references of `type=\"include\"` pointing to further OPML documents, or any other valid OPML content.\n\nIf in-use by a website, a request to the `feeds` well-known resource endpoint must return a valid OPML document using the `text/x-opml`, `application/xml`, or `text/xml` MIME type.\n\n## As an alternative to `Link:`/`\u003clink rel=\"alternate\"\u003e`\n\n`.well-known/feeds` supplements but does not replace the utility of techniques like `\u003clink rel=\"alternate\"\u003e` to reference RSS feeds associated with a web page. Specific differences include:\n\n- `.well-known/feeds` provides a single lightweight location from which a user agent can retreive feed information, obviating the need for `\u003clink\u003e` headers delivered with every page\n- `.well-known/feeds` is especially suitable for websites with multiple feeds, for example a news site or community weblog with different categories of feed\n- `\u003clink rel=\"alternate\"\u003e` remains the best way to associate a feed with a specific page rather than with the entire site\n\n## Use Cases\n\n`.well-known/feeds` benefits:\n\n- Content publishers who want to promote their feeds in a site-wide way\n- Producers of feed reader software who need a way to enumerate feeds belonging to a site that a subscriber might like to add to their reading list\n- Content consumers who want to use their feed reader see a \"menu\" of possible subscriptions available from a particular website\n- Syndication services that want to be able to dynamically subscribe to new feeds published by a site, as they're added\n\n## Security Considerations\n\nThere are no security considerations for this well-known resource identifier.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan-q%2Fwell-known-feeds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdan-q%2Fwell-known-feeds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan-q%2Fwell-known-feeds/lists"}