Skip to main content
source

this is a rendered mirror of the normative spec at github.com/declared-md/spec. in case of conflict, the source repository wins.

changelog

all notable changes to the declared-md spec are documented here.

format follows Keep a Changelog. this spec follows semantic versioning.

[1.0.1] - 2026-04-26​

changed​

  • links object in all three schemas now accepts arbitrary keys. previously restricted to a fixed set of known keys. any key whose value is a valid https:// URL is accepted. the email key is the only exception: it accepts a mailto: URI instead of an HTTPS URL.
  • links.github in whoami.schema.json now validates that the URL points to github.com (pattern ^https://github\.com/.+), not just any HTTPS URL.
  • removed format: "uri" annotations from link URL fields; validation is now done via pattern: "^https://" through additionalProperties.
  • whois.schema.json: added if/then rule enforcing that at least one of site or github must be present when links is included.

[1.0.0] - 2026-04-26​

added​

  • whoami.md v1.0: normative specification for individual identity profiles
  • whois.md v1.0: normative specification for organization identity profiles
  • whatis.md v1.0: normative specification for project identity profiles
  • shared.md: rules shared across all three standards
  • JSON Schema draft-07 for each standard
  • full example files for each standard