Skip to content

Comments

Polish Chapter 1 wording and standards references#97

Merged
drbruced12 merged 1 commit intoSystemsApproach:masterfrom
Walentalien:fix/ch1-editorial-pass1
Feb 20, 2026
Merged

Polish Chapter 1 wording and standards references#97
drbruced12 merged 1 commit intoSystemsApproach:masterfrom
Walentalien:fix/ch1-editorial-pass1

Conversation

@Walentalien
Copy link
Contributor

This PR applies a first editorial pass across Chapter 1 (Foundation) with high-confidence wording and consistency fixes.

Summary of changes:

  • Clarify grammar and phrasing in foundation/problem.rst, foundation/software.rst, and foundation/trend.rst.
  • Fix a grammar issue in foundation/architecture.rst ("more than one protocol").
  • Correct standards references in foundation/architecture.rst:
    • IEEE 802.3 Ethernet + 802.11 Wi-Fi
    • ITU-T H.264 video encoding standard
  • Fix missing terms in foundation/performance.rst (adds missing latency, RTT, and link in transfer-time discussion).

Validation:

  • Ran make spelling successfully (existing repo-wide spelling warnings remain unchanged).

Copy link
Contributor

@drbruced12 drbruced12 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks again. I think H.232 might have been a typo for H.323, but H.264 works well given that we call out video specifically. You've also found a family of bugs from the 5E->6E conversion in which some words that were formatted as sans serif got dropped altogether - hence the missing words in a few cases.

@drbruced12 drbruced12 merged commit 39bf698 into SystemsApproach:master Feb 20, 2026
2 checks passed
@Walentalien Walentalien deleted the fix/ch1-editorial-pass1 branch February 20, 2026 09:31
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.

2 participants