Subdomain registry¶
Unlike is-a.dev
and Open Domains where subdomain ownership data is coupled with
DNS records in one JSON file per subdomain, we chose to seperate them from the
underlying DNS records to seperate concerns without having to maintain additional
code parsing them and programmatically manage them (we use octoDNS for YAML-based
DNS records as code) and to simplify maintainer workload.
Where they are managed?¶
Subdomain registry data are stored and managed as good old YAML files in the
data
directory. Subdomain maintainers can edit their own data via the
GitHub/GitLab flow.
Our YAML schema for those are in the root of data
directory named as
registry-data.json
file for use in your editors and validation
tooling.
API Docs¶
API documentation for the registry is available at https://api.lorebooks.wiki/docs (source code), alongside some utilities we built around the data.