Organizational and governance regulation
1. Purpose of the regulation
Section titled “1. Purpose of the regulation”This regulation gives concrete form to the organization, responsibilities, and decision-making processes of TextRefs. It is intended to ensure that the association is run in a non-profit, transparent, open, scientifically accountable, and legally sound manner.
2. Governance principles
Section titled “2. Governance principles”The governance of the association rests on the following principles:
- Public benefit: all activities serve scholarship, education, culture, and open digital infrastructure.
- Openness: public registry data and documentation are freely accessible as a matter of principle.
- Persistence: published identifiers shall remain durably reachable.
- Transparency: changes, decisions, releases, and status changes are documented.
- Community curation: contributions from the specialist community are welcome and reviewed by transparent procedures.
- Risk-based review: simple technical changes require technical review; contested or structure-shaping changes require expert review.
- Rights safety: the association avoids hosting protected content and documents rights and access information for external targets.
- Neutrality: no external resolver, platform, or identifier system enjoys privileged status as primary internal identity.
- Non-discrimination in use: the use of public data does not depend on membership.
- Avoidance of self-dealing: financial or reputational conflicts of interest are disclosed and regulated.
3. Roles
Section titled “3. Roles”3.1 Board
Section titled “3.1 Board”The Board carries overall responsibility for the association, its finances, tax exemption, legal compliance, institutional strategy, and pursuit of purpose.
It decides in particular on:
- the budget and financial planning;
- grant applications and major cooperations;
- expense and compensation matters;
- the appointment of maintainers and expert councils;
- guidelines on data, rights, takedown, and releases;
- escalations from the curation process;
- legally or reputationally sensitive publications.
3.2 Technical Maintainers
Section titled “3.2 Technical Maintainers”Technical Maintainers look after the technical infrastructure, schemata, validation, build processes, releases, and technical pull-request review.
Their tasks include in particular:
- checking data formats and schema conformity;
- maintaining JSON-LD contexts, Zod schemas, and JSON-Schema-compatible exports;
- checking referential integrity;
- checking for prohibited full-text content;
- maintaining CI/CD and release automation;
- producing changelogs and data exports;
- technical documentation.
3.3 Domain Reviewers
Section titled “3.3 Domain Reviewers”Domain Reviewers are subject-matter qualified persons for specific text corpora, languages, periods, disciplines, or citation traditions.
They review in particular:
- new works;
- new citation and reference systems;
- new corpora;
- contested reference points;
- complex mapping statements;
- normalization decisions;
- changes that affect persistent IDs or established citation logic.
3.4 Advisory Board
Section titled “3.4 Advisory Board”The Board may establish a scientific or institutional advisory board.
The advisory board has an advisory function. It may provide recommendations on strategy, scientific quality, partnerships, priorities, sustainability, and international compatibility.
3.5 Contributors
Section titled “3.5 Contributors”Contributors are individuals or institutions who submit issues, pull requests, mapping proposals, documentation improvements, data corrections, or other contributions.
A contribution does not establish a claim to acceptance, prioritization, publication, compensation, or membership.
4. Review tracks
Section titled “4. Review tracks”4.1 Technical review
Section titled “4.1 Technical review”A technical review is usually sufficient for:
- typos;
- formatting corrections;
- broken links;
- minor metadata corrections;
- updates to
last_checkedfields; - adding uncontested aliases;
- documentation corrections without expert implications.
Prerequisites:
- automated validation passing;
- no prohibited full-text content;
- no rights or takedown concerns;
- no changes to persistent IDs with expert-level impact;
- at least one technical review by an authorized person.
4.2 Expert review
Section titled “4.2 Expert review”An expert review is required for:
- new corpora;
- new works;
- new citation or reference systems;
- new normalization rules;
- changes to deterministic ID inputs;
- contested mapping statements;
- conflicting external identifiers;
- changes with significant expert or reputational impact;
- status changes to
active,deprecated,withdrawn, orblocked, where these are subject-matter decisions.
Prerequisites:
- technical validation passing;
- a documented rationale;
- sources or evidence;
- at least one expert review;
- for contested decisions, a documented decision with rationale.
4.3 Board reservation
Section titled “4.3 Board reservation”The Board decides or confirms:
- legally sensitive publications;
- takedown decisions;
- blocking of mapping statements on legal or policy grounds;
- cooperations with financial, legal, or strategic binding effect;
- changes to licence policy, persistence policy, or matters relevant to tax exemption;
- paid engagements for Board members or persons close to them.
5. Status model
Section titled “5. Status model”5.1 General record status
Section titled “5.1 General record status”- candidate: proposed record, not yet fully reviewed;
- active: valid and recommended;
- deprecated: no longer recommended, but retained for historical reasons;
- withdrawn: withdrawn, landing page retained;
- blocked: blocked on legal, policy, or serious quality grounds.
5.2 Mapping status
Section titled “5.2 Mapping status”- candidate: proposed mapping;
- active: reviewed and recommended mapping;
- deprecated: mapping no longer recommended;
- withdrawn: withdrawn mapping;
- blocked: blocked mapping.
Contested mappings remain in the appropriate schema status and carry the documented rationale, review history, or replacement relationship in accompanying metadata or decision records.
5.3 Tombstone principle
Section titled “5.3 Tombstone principle”Published IDs are, as a matter of principle, not hard-deleted.
In the event of withdrawal, blocking, or deprecation, a landing page is retained with:
- status;
- date of the status change;
- rationale;
- responsible decision level;
- replacement ID, if any;
- a note on takedown or rights grounds, where relevant.
6. ID and persistence policy
Section titled “6. ID and persistence policy”- Primary TextRefs IDs are independent HTTP URIs.
- External identifiers such as CTS URNs, Wikidata IDs, DOIs, ARKs, Perseus URLs, or Scaife URLs are not primary TextRefs IDs.
- Stable and established references may receive deterministic IDs.
- Provisional or uncertain objects receive generated IDs.
- Once published, IDs are not changed merely because labels, titles, aliases, or external mappings are improved.
- Human-readable citation URLs are aliases and may be redirected, changed, or deprecated; primary IDs remain authoritative.
7. Contribution process
Section titled “7. Contribution process”7.1 Submission
Section titled “7.1 Submission”Contributions should, as a rule, be submitted via public GitHub issues or pull requests.
A contribution should include:
- the entity concerned or the proposed new entity;
- the type of change;
- a rationale;
- sources or evidence;
- an assessment of uncertainty;
- rights and licence notes where relevant.
7.2 Review
Section titled “7.2 Review”The contribution is triaged and assigned to a review track:
- technical change;
- expert change;
- legally or policy-sensitive change;
- incomplete or unreviewable contribution.
7.3 Acceptance
Section titled “7.3 Acceptance”A contribution may be accepted when:
- automated validation passes;
- the required reviews have taken place;
- rights and licence questions are sufficiently clarified;
- the contribution is compatible with the purpose, data model, and governance;
- status, provenance, and uncertainties are appropriately documented.
7.4 Rejection
Section titled “7.4 Rejection”A contribution may be rejected, in particular when:
- it contains prohibited full-text content;
- the rights or licence situation is unclear or problematic;
- the evidence is insufficient;
- it violates the data model or the persistence policy;
- it favours commercial, proprietary, or exclusive interests in an incompatible manner;
- it is incompatible with the non-profit purpose.
Rejections should be briefly justified.
8. Release and archiving policy
Section titled “8. Release and archiving policy”- The association publishes regular versioned dataset releases.
- Each release contains a changelog.
- Releases shall be reproducible.
- Data exports may be provided in particular as JSON-LD and JSONL.
- Important releases shall be archived durably via Git tags and, where possible, via Zenodo or a comparable archiving infrastructure.
- Schema changes are versioned.
- Breaking changes to schemata require a new major version.
9. Rights and takedown process
Section titled “9. Rights and takedown process”9.1 Principle
Section titled “9.1 Principle”TextRefs does not, as a matter of principle, host copyright-protected edition texts, critical apparatus, commentaries, or translations from protected editions.
The association primarily publishes reference data, metadata, external identifiers, resolver targets, mapping statements, provenance, and status information.
9.2 Rights metadata
Section titled “9.2 Rights metadata”Resolver targets and mapping statements shall, where possible, include information on:
- provider or source;
- access status;
- rights or licence status;
- licence URL, if any;
- date of last check;
- provenance;
- confidence level.
9.3 Prohibited content
Section titled “9.3 Prohibited content”The following shall in particular not be ingested:
- copyright-protected full texts without a licence;
- critical apparatus from protected editions;
- protected commentaries or translations without a licence;
- proprietary segmentation or mapping data from sources with unclear rights;
- data that circumvent technical protection measures or paywalls;
- bulk imports from sources without a clear rights or licence basis.
9.4 Takedown requests
Section titled “9.4 Takedown requests”A takedown request should include:
- verifiable contact information;
- the precise TextRefs URL or record ID;
- a precise description of the contested material;
- the basis of the alleged rights or policy violation;
- a statement that the information is true to the best of the requester’s knowledge.
9.5 Handling
Section titled “9.5 Handling”The Board or a body designated by it reviews the request.
Possible measures:
- no action where the request is manifestly unfounded;
- correction of metadata;
- change of access or rights status;
- deprecation of a mapping statement;
- blocking of a resolver target;
- redaction of certain fields;
- temporary de-publication pending clarification;
- publication of a tombstone or takedown notice.
CanonicalReference, Work, and CitationSystem IDs shall not be deleted merely because an external link or mapping is problematic.
10. Financial and compensation principles
Section titled “10. Financial and compensation principles”- The association’s funds may be used only for the non-profit purpose.
- The Board serves on a volunteer basis as a matter of principle.
- Effective, necessary, and documented expenses are reimbursed.
- Special services may be compensated appropriately where they are purpose-bound, budgeted, documented, and proportionate.
- Affected persons recuse themselves from decisions on their own compensation.
- Engagements for Board members or persons close to them are permitted only where they serve the association’s purpose, are at market rate, and are resolved transparently.
- Donations and grants are used in accordance with their purpose.
- Purpose-bound funds are documented separately in a traceable manner.
11. International activity
Section titled “11. International activity”TextRefs addresses an international user base in scholarship, education, culture, and digital infrastructure.
International impact is compatible with public benefit because the activity is open, non-commercial, scholarship- and education-related, and serves the general public.
The registered office in Zürich serves as the legal and organizational anchor. The association maintains transparency, accounting, dedication of funds, and governance according to Swiss standards.