Skip to content

Editorial: comprehensive typo and grammar pass over all learn.adacore.com content#1358

Open
gusthoff wants to merge 19 commits into
AdaCore:mainfrom
gusthoff:content/general/review/editorial/typos_grammar/20260522
Open

Editorial: comprehensive typo and grammar pass over all learn.adacore.com content#1358
gusthoff wants to merge 19 commits into
AdaCore:mainfrom
gusthoff:content/general/review/editorial/typos_grammar/20260522

Conversation

@gusthoff
Copy link
Copy Markdown
Collaborator

Summary

Full proofreading pass over all prose in the content/ tree — courses, labs,
and booklets. Only prose was touched; code blocks, RST markup, inline :ada:
and :c: roles, section titles, labels, and index entries were left untouched.

Scope

Every course, lab, and booklet published on learn.adacore.com:

  • Introduction to Ada (course + labs)
  • Advanced Ada
  • Advanced SPARK
  • Ada for the C++/Java Developer
  • Ada for the Embedded C Developer
  • Introduction to GNAT Toolchain
  • Guidelines for Safe and Secure Ada/SPARK
  • SPARK for the MISRA-C Developer
  • Ada in Practice
  • Introduction to SPARK
  • Introduction to Embedded Systems Programming
  • What's New in Ada 2022
  • Bug Free Coding (lab)
  • AdaCore Technologies for Airborne Software (booklet)
  • AdaCore Technologies for Railway Software (booklet)
  • AdaCore Technologies for Space Systems Software (booklet)
  • Site-level pages (about, index)

Types of fixes

  • Typos and misspellings
  • Missing or misplaced commas and other punctuation
  • Wrong articles (a vs an, missing the)
  • Tense and number agreement
  • Hyphenation of compound modifiers
  • Awkward or non-standard word choices (e.g. instableunstable,
    suitabilitysubstitutability)

Out of scope

Content and factual issues found during proofreading (wrong variable names,
wrong type names, incorrect prose descriptions of code) were deliberately
not fixed here.

@gusthoff gusthoff requested a review from swbaird May 24, 2026 23:05
@gusthoff gusthoff changed the title Editorial: comprehensive typo and grammar pass over all learn.adacore.com content Description: Editorial: comprehensive typo and grammar pass over all learn.adacore.com content May 25, 2026
gusthoff and others added 19 commits May 25, 2026 17:01
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…PARK"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…gramming"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ftware"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…tware"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ms Software"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Restore correct column width and capitalisation on the "Multiplying
operators" row, which had one extra trailing space that misaligned the
right border.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@gusthoff gusthoff force-pushed the content/general/review/editorial/typos_grammar/20260522 branch from 638ed0a to 45ac5d6 Compare May 25, 2026 15:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant