Skip to content

A reading pass for prose that explains the book against its source #6

Closed

Description

@arademaker

The rule is broken by prose that explains why this book does something
differently, even when it never names the source. No grep finds this class: a
scan for markers ("ao pé da letra", "se traduz", "mantemos", "no original")
returned only legitimate uses of "tradução". Someone has to read the prose.

Two instances were found and fixed this way in Logic/PL.lean, so the class
is real. The criterion for judging what turns up is in DEVIATIONS.md.

Related mechanical check, to re-run after each migration:
página \d+, \(p\. \d+, §\s*\d, exemplo \(\d+\.\d+\),
Exercício \d+\.\d+, Seção \d+\.\d+. Note that
Morphology/FinnishVowelHarmony.lean's [For07, p. 13] is a legitimate
bibliographic citation the sweep will keep flagging.

Activity

  1. added
    styleConformance with STYLE-CODE.md or STYLE-WRITING.md
    choreMechanical upkeep
    on Sep 11, 2026
  2. arademaker commented on Sep 26, 2026

    @arademaker
    MemberAuthor

    Closing: the reading pass will happen as part of the chapter revisions, not as a separate task. The criterion now lives in STYLE-WRITING.md, and the mechanical check (citations of CSwFP, pages, sections and exercise numbers outside :::dev) is part of scripts/check-cswfp.py, added in #32.

  3. added a commit that references this issue on Sep 26, 2026
    8f23a2e
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

    choreMechanical upkeepstyleConformance 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