- Copy
data/_template.json.txt to data/<acronym-lowercase>.json.
- Fill in the fields (see
SCHEMA.md). Leave anything unknown as null or "to be filled"; never guess. Leave issn as null if there is no ISSN; the line is then simply omitted.
- List editors by name and affiliation only (no emails). Add indexing only if it is verified from the journal’s own site, with the source URL.
- Put the publisher, if you need to record it, under
internal; it is never displayed.
- Run
python3 build.py. The count, filters, card, and journal page all update automatically.
- Review
dist/ and GAPS.md, then publish (deployment is a separate, approved step).
Starter file
{
"id": "xyz",
"acronym": "XYZ",
"name": "Journal of Example Studies",
"status": "launching",
"group": null,
"featured": false,
"url": "https://example.org/xyz",
"subjects": ["technology"],
"issn": null,
"doi": null,
"language": "English",
"frequency": "to be filled",
"access": "to be filled",
"scope": "to be filled",
"indexing": {"status": "to_be_verified", "items": [], "aiming_for": [], "note": null},
"editors": [{"name": "Full Name", "role": "Editor-in-Chief", "affiliation": "Institution, Country"}],
"cfp": {"status": "unknown", "text": null, "url": null},
"latest_issue": {"label": null, "note": null, "url": null},
"flags": [],
"internal": {"publisher": "never displayed", "notes": "never displayed"},
"sources": ["URL(s) where the facts were checked"],
"retrieved": "2026-10-27"
}