Skip to content

Root design documents in Russian: remove or translate? (owner decision) #14

Description

@arkh-node

Eight internal design documents are tracked in the repo root:

АЛГЕБРА_v0.md, ГРАММАТИКА_v0.md, КОНТРАКТ.md, ПОРОГ_θ_v0.md, ПРИМЕР_ФАРМАКОЛОГИЯ.md, ПРИМЕРЫ_v0.md, РЕДУКЦИЯ_v0.md, ТИПЫ_v0.md

These are v0 design specs in Russian. A public language repo probably should not carry them as-is. Two options:

  1. Remove — internal working documents; git history preserves them.
  2. Translate — if some are meant to be public documentation. КОНТРАКТ.md documents verifiable validator guarantees and is a natural public doc (CONTRACT.md); ПРИМЕР_ФАРМАКОЛОГИЯ.md is the worked pharmacology example.

Known dangling references:

  • README.md:74 points at ПРИМЕР_ФАРМАКОЛОГИЯ.md — must be fixed in the README translation regardless.
  • test/E1_pharma.lisp and test/I1_support.lisp reference the same document in comments.
  • КОНТРАКТ.md text references an internal report path (reports/R2_...) that does not exist in the repo — needs sanitization if translated.

Owner call needed: which of the eight stay (translated) and which go. Everything else in the cleanup does not depend on this decision.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions