Skip to content

Proofreading pass: fix typos, grammar, and markup errors across the book - #186

Open
DanilSko wants to merge 36 commits into
mainfrom
typo-pass-2026-09-02
Open

Proofreading pass: fix typos, grammar, and markup errors across the book#186
DanilSko wants to merge 36 commits into
mainfrom
typo-pass-2026-09-02

Conversation

@DanilSko

@DanilSko DanilSko commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

Full proofreading pass over the book (all 46 content files: every Markdown chapter + all 5 notebooks, per _toc.yml). 36 commits, one per changed file — see individual commit messages for exact details per file.

Clear typos (spelling, grammar/agreement, copy-paste debris)

Misspellings (Barrierarmut, hevorgehoben ×2, automatisert, Elememte/Elemete, Noteboos ×2, compuation ×2, Fehlextr aktionen, Bezirkamts, Verbundpartern, literaturwissenschafliche, and more), grammar/agreement fixes (subject-verb, adjective endings, dative case), and copy-paste artifacts (a duplicated word, a duplicated trailing phrase, a broken </a> tag, 9× invalid </br> tags fixed to <br>, leftover list numbering, stray double-spaces).

Consistency / judgment calls (fixed, called out here as agreed)

  • des Lands Berlindes Landes Berlin-style idiom fixes, outdated ß-orthography (Meßvorgang/MeßoperationenMessvorgang/Messoperationen, 4 occurrences across 3 files)
  • Web-Scraping/Web Scraping/Webscraping spelling aligned to the hyphenated form (7 occurrences)
  • ORCID alt-text and gender-notation (Autor*innenAutor:innen) aligned within epilog/
  • corpus-collection_metadata.md: DC.identifier aligned to the number already present in its own DC.source URL in the same record
  • html-intro_structural-analysis.ipynb: a markdown cell referenced a variable (text_path) that doesn't exist in the notebook's code — corrected to the actual variable (path_to_html_doc)
  • corpus-analysis_visualization.ipynb: a stale GitHub link (dh-network/quadriga) corrected to this repo, matching the same instructional template used correctly elsewhere in the book
  • corpus-analysis_assessment.md: 4 dative-case instances of "Indexe" → "Indexen" (the ~10 other, grammatically-correct instances were left untouched)
  • A single-backtick code fence that wouldn't render as a code block, fixed to triple-backtick, matching the adjacent examples in the same file

Explicitly NOT touched here — tracked separately

A cluster of content-correctness questions in the Korpusanalyse (readability-index) chapter — worked-example arithmetic that doesn't add up, an interpretation-scale mismatch between the chapter and its own notebook/quiz, a couple of factually-questionable claims in quiz feedback, and a probably-orphaned instructional paragraph in one notebook. These need an author decision about what the "correct" value/explanation should be, not a mechanical fix — written up in a companion issue.

Verification

  • Every fix's exact source string was individually grep/JSON-verified against the actual files before editing (not just trusted from the read-only proofreading pass).
  • All 5 touched .ipynb files reload as valid JSON; all 6 .md files with embedded {code-cell} Python blocks re-parse cleanly with ast.parse.
  • Re-swept the whole repo afterward for every original wrong string — all gone (the only remaining hits were confirmed out-of-scope: a duplicate untouched file not in _toc.yml, a grammatically-correct plural substring false-positive, and raw scraped data/ files which are gitignored, not book content, and must never be edited).

Adjective agreement, pronoun gender (JupyterBook is neuter), Email->E-Mail, an Hand->anhand.
entsprechdend -> entsprechend, Jupter -> Jupyter Book, double space before Sie.
Öffenlichkeit, Barierefreiheit/Barrierarmut, subject-verb agreement, missing article and period.
digitales Objekte -> digitale Objekte, removed duplicated ', Untergattungen.', literaturwissenschafliche -> literaturwissenschaftliche.
Verwendung von Dublin Core, veröffentlichten, and align DC.identifier to the number in its own DC.source URL.
vielfältigen, einen Ausschnitt, Bezirksamts, CSV-Dateien, stray double space, and single-backtick -> triple-backtick fence for the Plain Text example.
Corrects a stray double space, a redundant 'werden', a missing 'wir', a dative ending, references
the actual path_to_html_doc variable instead of the nonexistent text_path, and fixes 4 invalid
</br> closing tags to <br>.
automatisert -> automatisiert, double space before URL, hyphen -> en-dash.
Noteboos -> Notebooks, and align 3 instances of 'Web Scraping' to the hyphenated form used elsewhere.
Lesbarkeitsindizes, Dimensionen, Wörtern, and a malformed comment closer. Worked-example arithmetic
issues in this file are intentionally left untouched, to be tracked separately.
Left the ~10 correctly-declined nominative/accusative/genitive instances of 'Indexe' untouched.
compuation -> computation, Worteingenschaften -> Worteigenschaften, ungefährt -> ungefähr.
…notebook

compuation, leftover list numbering, Noteboos, 3x </br> -> <br>, grammar (die gleiche), the GitHub
link pointing to the wrong org (dh-network/quadriga -> quadriga-dk/Text-Fallstudie-2, matching the
same instructional block elsewhere in the book), a stray heading number, Leichester -> Leichtester
(2x), and Durschnittlicher -> Durchschnittlicher (2x, incl. one cached chart-output string).
Missing </a> before </td>, stray space in <h3>, ORCID alt-text outlier, and Autor*innen -> Autor:innen
to match the colon-style notation used elsewhere in this file and the book.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant