Skip to content

docs clean up and fix up - spelling, grammar, and style guide alignment#2

Merged
tfpauly merged 3 commits into
mainfrom
docs-cleanup
Jun 10, 2026
Merged

docs clean up and fix up - spelling, grammar, and style guide alignment#2
tfpauly merged 3 commits into
mainfrom
docs-cleanup

Conversation

@heckj

@heckj heckj commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

variety of docs updates - fixing spelling, grammar, voice, tense, and alignment with Apple's style guides

Comment thread Sources/SwiftNetwork/Endpoint/IPv4Address.swift Outdated
Comment thread Sources/SwiftNetwork/Endpoint/IPv6Address.swift Outdated
final class EndpointFlow: CustomDebugStringConvertible {

/// Datapath logging
/// The data path logging state.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
/// The data path logging state.
/// State used to emit logs on the data path.

Comment thread Sources/SwiftNetwork/EndpointFlow/EndpointFlow.swift Outdated
Comment thread Sources/SwiftNetwork/Parameters/Parameters.swift
Comment thread Sources/SwiftNetwork/Protocols/BottomProtocol.swift Outdated
Comment thread Sources/SwiftNetwork/Protocols/BottomProtocol.swift Outdated
Comment thread Sources/SwiftNetwork/Protocols/BottomProtocol.swift Outdated
Comment thread Sources/SwiftNetwork/Protocols/OneToOneProtocol.swift Outdated
Comment thread Sources/SwiftNetwork/Protocols/OneToOneProtocol.swift Outdated
- Restore Connection.swift and Parameters.swift to original wording
  to keep them aligned with the public SDK headerdoc.
- Drop incorrect "on behalf of" phrasing in BottomProtocol.swift and
  OneToOneProtocol.swift; rewrite to describe what each function
  returns to or sends from the upper protocol.
- Apply line suggestions:
  - IPv4Address/IPv6Address: use 'IPv4 "any" address' / 'IPv6 "any"
    address' instead of "any-address".
  - EndpointFlow: clarify log property doc and restore "Cancelled"
    spelling to match the public API.
  - PathProperties: drop hyphen from "link-quality measurement".
@heckj heckj requested a review from tfpauly June 9, 2026 22:56

@agnosticdev agnosticdev left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Just a few items, thank you for doing this!

Comment thread Sources/SwiftNetwork/Connection/Connection.swift Outdated
Comment thread Sources/SwiftNetwork/QUIC/ECN.swift Outdated
Comment thread Sources/SwiftNetwork/QUIC/Prague.swift Outdated
Comment thread Sources/SwiftNetwork/System/SystemSocket.swift Outdated
Comment thread Sources/SwiftNetwork/QUIC/Prague.swift Outdated
Comment thread Sources/SwiftNetwork/QUIC/ECN.swift Outdated
Comment thread Sources/SwiftNetwork/System/SystemSocket.swift Outdated
Co-authored-by: Tommy Pauly <tpauly@apple.com>
@tfpauly tfpauly merged commit ab5e472 into main Jun 10, 2026
20 checks passed
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.

3 participants