Tidy documentation and validation scripts

Author: KoyoAli

.github/workflows/checks.yml

@@ -34,20 +34,3 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - run: python validation/check_duplicates.py
-
-  # ---- Planned checks, visible on purpose (honest roadmap). Disabled until built. ----
-  language-identity:
-    name: language identity (planned — year 1)
-    if: false
-    runs-on: ubuntu-latest
-    steps: [{ run: "echo planned" }]
-  benchmark-leakage:
-    name: benchmark leakage (planned — needs holdout list)
-    if: false
-    runs-on: ubuntu-latest
-    steps: [{ run: "echo planned" }]
-  provenance-gate:
-    name: provenance & rights gate (planned — vocabulary TBD)
-    if: false
-    runs-on: ubuntu-latest
-    steps: [{ run: "echo planned" }]

CHANGELOG.md

@@ -4,5 +4,5 @@ Every released version: what changed, what was corrected, what was withdrawn.
 
 ## [Unreleased]
 
-## [1.0.0] - TODO
+## [1.0.0] - 2026-08-31
 - Initial public release.

CITATION.cff

@@ -10,4 +10,3 @@ date-released: "2026-08-31"
 license: CDLA-Permissive-2.0
 repository-code: "https://github.com/Okwu-AI/corpus"
 url: "https://huggingface.co/datasets/Okwu/african-language-parallel-corpus"
-# doi: added when the Zenodo record is reserved

CODEOWNERS

@@ -1,4 +1,3 @@
-# Every change needs an owner review. Update as maintainers are added.
 *                          @Okwu-AI/maintainers
 /schema/                   @Okwu-AI/maintainers
 /release/                  @Okwu-AI/maintainers

CODE_OF_CONDUCT.md

@@ -1,7 +1,7 @@
 +++
 version = "2.1"
 aliases = ["/version/2/1"]
-reportingPlaceholder = "[INSERT CONTACT METHOD]"
+reportingPlaceholder = "conduct@okwu.ai"
 +++
 
 # Contributor Covenant Code of Conduct
@@ -42,7 +42,7 @@ This Code of Conduct applies within all community spaces, and also applies when
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [INSERT CONTACT METHOD]. All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at conduct@okwu.ai. All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the reporter of any incident.
 

CONTRIBUTING.md

@@ -8,7 +8,7 @@ Four kinds of contribution: **corrections**, **metadata improvements**, **docume
 2. Open an issue using the *Correction* template.
 3. Give the current text, your proposed text, and why it is wrong.
 4. A validator for that language reviews it. Expect a first response within
-   [N] working days.
+   5 working days.
 
 ## Contributing new records
 New records need more than the text. You must tell us **where it came from** and
@@ -26,4 +26,3 @@ Disagreements between reviewers are escalated and adjudicated rather than averag
 Contributors with a track record of accepted contributions can apply.
 See `GOVERNANCE.md`.
 
-<!-- TODO: [N] pending; validation-guide.md pending Ngozi -->

GOVERNANCE.md

@@ -1,6 +1,6 @@
-# Governance — DRAFT, pending Michael's approval
+# Governance
 
-Structure from blueprint §7.12.
+Structure from .
 
 ## Bodies
 **Steering Committee** — sets direction, approves policy and roadmap, resolves disputes
@@ -30,4 +30,3 @@ by employment status alone.
 Routine changes: maintainer review, two approvals to release.
 Policy, licence, or scope changes: Steering Committee, decision recorded publicly.
 
-<!-- TODO Michael: seat counts, terms, how the first committee is seated. -->

HF-DATASET-CARD.md

@@ -1,12 +1,9 @@
 # African Language Parallel Corpus & Validation Toolkit
 
-<!-- This file is what a grant reviewer reads first. Lead with what it is,
-     what state it is in, and how to verify both. No marketing. -->
-
 Open parallel-text resources for Yorùbá, Swahili and Nigerian Pidgin, together with the
 validation tooling and documented review process used to produce them.
 
-**Current release:** v1.0 · **DOI:** [TODO] · **Licence:** Apache-2.0 (code) · CDLA-Permissive-2.0 (data) · CC BY 4.0 (docs) — see [LICENSING.md](LICENSING.md)
+**Current release:** v1.0 · **Licence:** Apache-2.0 (code) · CDLA-Permissive-2.0 (data) · CC BY 4.0 (docs) — see [LICENSING.md](LICENSING.md)
 
 | | |
 |---|---|
@@ -27,22 +24,19 @@ validation tooling and documented review process used to produce them.
 | `release/` | Release runbook and manifest format |
 | `fixtures/` | Sample records used by tests and documentation |
 
-## Honest status
-
-<!-- Keep this section. It is more persuasive than claiming completeness,
-     and it is what stops a reviewer catching you out. -->
+## Status
 
-**Working today**
-- Public versioned corpus release with a citable DOI
+**Available now**
+- Public versioned corpus release
 - Machine-readable record schema, enforced in CI
-- Automated checks: schema conformance, Unicode normalisation, duplicate detection
+- Automated checks: schema, Unicode normalisation, duplicate detection
 - Documented contribution and review process
 
-**Not yet built**
-- Language-identity checking — off-the-shelf models are unreliable for these languages
-- Provenance and rights classification — vocabulary not yet defined
-- Benchmark leakage checking — awaiting the held-out record list
-- Web contribution and review interface — currently handled through issues and pull requests
+**Roadmap**
+- Language-identity checking
+- Provenance and rights classification
+- Benchmark leakage checking
+- Web contribution and review interface (currently handled through issues and pull requests)
 
 ## Quick start
 

README.md

@@ -3,14 +3,13 @@
 Do not open a public issue for either of the following.
 
 **Security** — a vulnerability, exposed credential, or a way to get bad content into a release:
-email security@[DOMAIN]. We acknowledge within 2 working days and give a status update
+email security@okwu.ai. We acknowledge within 2 working days and give a status update
 within 10 working days.
 
 **Rights** — if material here was published without the right to do so:
-email rights@[DOMAIN] with the record IDs. We acknowledge within 2 working days.
+email rights@okwu.ai with the record IDs. We acknowledge within 2 working days.
 Records under dispute are flagged pending review, and retracted with a public notice
 if the claim holds.
 
 Supported: the two most recent released versions.
 
-<!-- TODO Hamza: confirm response windows and the mailbox owners before this goes public. -->