declared-md
three markdown files. three subjects. publish them in a public GitHub repo. we index them.
the standards
| file | subject | directory |
|---|---|---|
whoami.md | individuals | /people |
whois.md | organizations | /orgs |
whatis.md | projects | /projects |
each standard is a small YAML frontmatter schema in a Markdown file. the file lives in the subject's own GitHub repository. the subject controls the data. any directory that indexes it is a derived view, not the source.
quick links
- get started in 5 minutes
- whoami.md specification
- whois.md specification
- whatis.md specification
- cli reference
- architecture overview
- faq
core principle
the file is the source of truth. the directory is just a view.
if the directory disappears tomorrow, your file is still there. if you update your file, the directory catches up on the next crawl. there is no account to update, no dashboard to log into, no platform to depend on.