{
  "_meta": {
    "title": "The Parrots' Project — translation rules",
    "purpose": "Per-language rules for anyone translating or reviewing this site, human or machine. A translator reads the global block, then the block for their language. Nothing here is generated; every entry was decided by a person and is attributed.",
    "version": "1.0",
    "created": "2026-11-17",
    "maintainer": "EV Voltura",
    "how_to_add_a_language": "Copy the structure of an existing language block. Leave every field you cannot answer as null rather than guessing. A null field tells the next reviewer where to start; an invented field is worse than an empty one."
  },

  "global": {
    "project_name": {
      "rule": "Never translate. 'The Parrots' Project' is a proper noun and appears in English on every language edition, including in running text.",
      "reason": "No language has a vernacular umbrella term that covers the whole order Psittaciformes without either excluding part of it or dropping into technical register. Every candidate translation names a clade the project is not limited to. See the pt-BR block for the case that established this rule.",
      "decided_by": "EV Voltura, 2026-11-17, following a terminology report from Davi Butturi-Gomes",
      "applies_to": "page titles, headers, footers, metadata, alt text, and running prose"
    },

    "scope_gloss": {
      "rule": "Because the name is not translated, each language carries a short gloss naming the birds its readers recognize. The gloss does the work the name cannot.",
      "placement": "Directly beneath the project name on the homepage, and in the meta description.",
      "constraint": "List vernacular names, not taxonomic ranks. A reader should recognize the birds, not be taught a classification.",
      "per_language": "See each language block."
    },

    "taxonomy_authority": {
      "rule": "Scientific names and English common names follow the current eBird/Clements checklist. Record the checklist version and review date wherever taxonomy is presented.",
      "note": "Vernacular names in other languages do NOT need to map onto Clements taxa, and usually cannot. See vernacular_names_do_not_track_clades."
    },

    "vernacular_names_do_not_track_clades": {
      "rule": "Do not build any translation rule on the assumption that a language's common names correspond to families, subfamilies or genera. In most languages they track body size, shape and familiarity instead.",
      "worked_example": "Portuguese papagaio (Amazona) and arara (Ara) are both subfamily Arinae, while periquito covers the budgerigar, which is in Psittaculidae, a different family entirely. Any rule mapping Portuguese names to clades will be wrong in both directions.",
      "consequence": "When a vernacular name is needed, choose the one a reader of that language would actually use for that bird, and let the scientific name carry the precision."
    },

    "display_names": {
      "rule": "The project's English display name for Psittacus erithacus is 'African Gray Parrot'. Grey and gray, and singular and plural, are treated as equivalent when matching, but 'African Gray Parrot' is what is displayed in English.",
      "other_languages": "Each language uses its own established common name. Do not calque the English spelling choice into other languages."
    },

    "published_titles": {
      "rule": "Titles of published works are never corrected, modernized, retranslated or taxonomically updated, in any language. They are quoted as published.",
      "includes": "outdated scientific names, misspellings, obsolete orthography, and names of institutions that have since changed"
    },

    "quotations": {
      "rule": "A quotation from a person is not translated silently. Either give the original with a translation marked as such, or give the original alone.",
      "reason": "A translated quotation attributed to a named person puts words in their mouth."
    },

    "machine_translation_disclosure": {
      "rule": "Any page whose text was produced by a language model and not yet checked by a fluent speaker carries the disclosure marker used site-wide.",
      "removal": "The marker is removed only when a named fluent speaker has reviewed the page. Record who and when in the language block below.",
      "note": "A review that enriches or rewrites the text is still a review. Record it."
    },

    "english_style_rules_are_english_only": {
      "rule": "The project's English prose rules (no em dashes; no sentence beginning with 'But' or 'Because'; semicolons only alongside 'however'; American English) apply to English text only.",
      "reason": "Punctuation conventions differ by language. Spanish and Portuguese use the em dash for dialogue and parenthesis in ways English does not, and German compounding and comma rules are not negotiable stylistic choices. Imposing English punctuation rules on another language produces text that reads as translated.",
      "decided_by": "EV Voltura"
    },

    "do_not_translate": [
      "The Parrots' Project",
      "scientific names (binomials, genus and family names)",
      "titles of published works",
      "institution names, unless the institution publishes its own name in that language",
      "personal names",
      "the names of file formats, software and checklists (eBird/Clements, Zotero)"
    ]
  },

  "languages": {
    "en": {
      "code": "en",
      "label": "English",
      "status": "source language",
      "reviewer": "EV Voltura",
      "reviewed": "ongoing",
      "scope_gloss": null,
      "gloss_note": "The English name already reads as an umbrella term, so no gloss is required. 'Parrot' in English covers the order in general usage.",
      "umbrella_term": {
        "exists": true,
        "term": "parrot",
        "note": "Covers Psittaciformes in general usage. 'Psittacine' is available for technical register."
      },
      "vernacular_notes": null,
      "machine_translated": false
    },

    "pt-BR": {
      "code": "pt-BR",
      "label": "Português (Brasil)",
      "status": "machine translated, awaiting native review",
      "reviewer": "Davi Butturi-Gomes",
      "reviewed": null,
      "scope_gloss": {
        "text": "Uma biblioteca dedicada a todos os Psittaciformes: papagaios, araras, periquitos, maracanãs, cacatuas e calopsitas.",
        "status": "draft, pending Davi's confirmation",
        "open_questions": [
          "Is maracanã current enough in general Brazilian usage to earn a place in this list, or is it regional?",
          "Should tiriba (Pyrrhura), jandaia (Aratinga) or tuim (Forpus) be added, or does a longer list stop reading as a sentence?"
        ]
      },
      "umbrella_term": {
        "exists": false,
        "note": "There is no non-technical Brazilian Portuguese term covering the whole order. 'Psitacídeos' is both technical and wrong for this purpose, since it names the family Psittacidae and so excludes the cockatoos. 'Psitaciformes' is accurate and technical."
      },
      "vernacular_notes": {
        "reported_by": "Davi Butturi-Gomes, 2026-11-17",
        "core_problem": "Readers encountering a translated project name containing 'papagaio' understand the project to be about Amazona and relatives only. Nobody in Brazil calls an Ara ararauna a papagaio; it is an arara.",
        "names_in_general_use": {
          "papagaio": "large short-tailed parrots, chiefly Amazona",
          "arara": "the large macaws",
          "maracanã": "smaller macaws; Davi associates it chiefly with the smaller Ara species",
          "periquito": "small long-tailed parrots, including the budgerigar (periquito-australiano)",
          "cacatua": "cockatoos generally",
          "calopsita": "the cockatiel, Nymphicus hollandicus, specifically"
        },
        "taxonomic_correction": "Davi's report grouped papagaio/periquito under Psittacinae and arara/maracanã under Arinae. Current classification does not support that split: Psittacinae holds only the 12 Afrotropical species, while Amazona and Ara are both Arinae, and the budgerigar is in Psittaculidae. The names track body size and shape rather than clade. This strengthens rather than weakens his conclusion, since it means no clade-based translation rule can work.",
        "correction_source": "eBird/Clements and the current Psittacidae classification, checked 2026-11-17",
        "distinguishing_cacatua_from_calopsita": "Straightforward in practice: calopsita is one species, the cockatiel. Every other cockatoo is a cacatua."
      },
      "machine_translated": true,
      "known_issues": [
        {
          "id": "pt-1",
          "severity": "factual error",
          "where": "page title and meta description",
          "problem": "Both use 'psitacídeos', which names the family Psittacidae and therefore excludes the cockatoos. The site has a cockatoo research section, so this misstates the project's own scope in the metadata search engines read.",
          "found": "2026-11-17",
          "status": "open"
        },
        {
          "id": "pt-2",
          "severity": "scope",
          "where": "homepage H1",
          "problem": "Reads 'Conectando o mundo do conhecimento sobre papagaios.' This is the exact issue Davi reported: the first line a Brazilian reader sees says the project is about Amazona.",
          "proposed": "Conectando o mundo do conhecimento sobre papagaios, araras, periquitos e cacatuas.",
          "proposed_status": "draft, not to be deployed without Davi's approval",
          "found": "2026-11-17",
          "status": "open"
        },
        {
          "id": "pt-3",
          "severity": "style",
          "where": "body text",
          "problem": "Runs 'O The Parrots' Project reúne…', stacking a Portuguese article on the English name. Possibly unavoidable given Portuguese grammar; a native speaker should say whether it grates and whether 'O projeto The Parrots' Project' reads better.",
          "found": "2026-11-17",
          "status": "open, needs Davi"
        }
      ]
    },

    "es": {
      "code": "es",
      "label": "Español",
      "status": "machine translated, awaiting native review",
      "reviewer": null,
      "reviewed": null,
      "scope_gloss": {
        "text": null,
        "status": "not drafted; needs a native speaker",
        "open_questions": [
          "Spanish divides the order much as Portuguese does, across loro, papagayo, guacamayo and cotorra, and usage differs substantially between Spain, Mexico and South America. Which regional usage should this edition follow?"
        ]
      },
      "umbrella_term": {
        "exists": null,
        "note": "Not settled. 'Loro' is the broadest term in much of Latin America but is not universally read as covering guacamayos and cacatúas. A native reviewer should decide before a gloss is written."
      },
      "vernacular_notes": null,
      "machine_translated": true,
      "known_issues": [
        {
          "id": "es-1",
          "severity": "open question, not an error",
          "where": "homepage H1, page title, meta description",
          "problem": "All three use 'loros'. The same page separately uses 'guacamayos' and 'cacatúas', so a reader may or may not hear 'loros' as covering them. 'Loro' is the broadest available Spanish term and no factually wrong term is in use, unlike Portuguese. A native speaker should decide whether a scope gloss is needed or whether the H1 should list names as proposed for Portuguese.",
          "found": "2026-11-17",
          "status": "open, no reviewer assigned"
        }
      ]
    },

    "de": {
      "code": "de",
      "label": "Deutsch",
      "status": "machine translated, awaiting native review",
      "reviewer": null,
      "reviewed": null,
      "scope_gloss": {
        "text": null,
        "status": "not drafted; may not be needed",
        "open_questions": [
          "German appears to have a working umbrella term in 'Papageien', with 'Kakadus' understood as a kind of Papagei. If a native reviewer confirms this, no gloss is required and this block can say so."
        ]
      },
      "umbrella_term": {
        "exists": true,
        "term": "Papageienvögel",
        "note": "German is the one language checked so far with a true vernacular umbrella term for the order. Attested in the German veterinary literature: Albicker-Rippinger & Hoop 1999 is titled 'Krankheitsursachen bei Papageienvögeln (Psittaciformes) und Sperlingsvögeln (Passeriformes)'. 'Papageien' alone is narrower in careful usage, with Kakadus and Sittiche named separately, but is commonly read as broad. A native speaker should decide which register the site wants.",
        "source": "Tierarztliche Praxis 27(K):245-254, read in full 2026-11-17"
      },
      "vernacular_notes": {
        "names_in_general_use": {
          "Papageienvögel": "the order Psittaciformes; the umbrella term",
          "Papageien": "parrots generally; broad in common usage, narrower in careful usage",
          "Sittiche": "parakeets and conures",
          "Kakadus": "cockatoos",
          "Loris": "lories and lorikeets"
        }
      },
      "machine_translated": true,
      "known_issues": [
        {
          "id": "de-1",
          "severity": "translation quality",
          "where": "body text, species group listings",
          "problem": "English nouns left untranslated where German has established terms. 'Sittiche' appears nowhere on the page; the English 'Conures' and 'Lorikeets' are used instead, as in 'Lories, Lorikeets, Conures und kleinere Papageien'. This is machine translation failing on bird-group names specifically.",
          "found": "2026-11-17",
          "status": "open, no reviewer assigned"
        },
        {
          "id": "de-2",
          "severity": "open question, not an error",
          "where": "homepage H1, page title",
          "problem": "Use 'Papageien' compounds ('Papageienwissens', 'Papageienforschung') where 'Papageienvögel' would be unambiguous about scope. Whether the gain in precision is worth the heavier word is a native speaker's call.",
          "found": "2026-11-17",
          "status": "open, no reviewer assigned"
        }
      ]
    },

    "zh-Hans": {
      "code": "zh-Hans",
      "label": "简体中文",
      "status": "machine translated, enrichment offered",
      "reviewer": "James Guo",
      "reviewed": null,
      "scope_gloss": {
        "text": null,
        "status": "not drafted; may not be needed",
        "open_questions": [
          "鹦鹉 appears to function as a true umbrella term covering the order, in which case no gloss is required. James to confirm.",
          "James has offered to enrich the existing translation, which he described as mechanical. Record the date when that is done so the disclosure marker can come off."
        ]
      },
      "umbrella_term": {
        "exists": null,
        "note": "Provisionally 鹦鹉, pending confirmation."
      },
      "vernacular_notes": null,
      "machine_translated": true
    }
  }
}
