Skip to content

Two paragraphs defend an editorial choice in the book's prose #5

Description

@arademaker

DEVIATIONS.md draws the line: a technical consequence in Lean is content, an
editorial preference is meta and belongs in DEVIATIONS.md. Two passages are
on the wrong side of it.

  • CSwL/Games/SeaBattle.lean:78 — "as colunas poderiam ter sido modeladas
    como as linhas, o que tornaria o design mais simples. Mas preferimos seguir
    o estilo de coordenadas usual". The clearest case: it reports what the
    authors decided.
  • CSwL/Games/SeaBattle.lean:144 — "Preferimos manter Game como está e
    formalizar a propriedade…". Harder, because it explains why the code does
    not match the grammar the previous exercise asks the reader to revise, and
    deleting it leaves the reader wondering. The fix is probably to state the
    predicate on its own terms rather than to cut the paragraph.

CSwL/English.lean:311 ("Nossa gramática poderia ser:") was checked and is a
false positive — it introduces a grammar, it does not defend a choice.
Recorded so a later sweep does not re-litigate it.

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

    styleConformance with STYLE-CODE.md or STYLE-WRITING.md

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions