diff --git a/Packages/Infrastructure/Sources/Public/Types/StructuredData.swift b/Packages/Infrastructure/Sources/Public/Types/StructuredData.swift index 9f5d219..813be3a 100644 --- a/Packages/Infrastructure/Sources/Public/Types/StructuredData.swift +++ b/Packages/Infrastructure/Sources/Public/Types/StructuredData.swift @@ -25,10 +25,10 @@ public struct StructuredData: Equatable, Sendable { // MARK: Methods - /// The `@id` of the `Organization` node ``init(name:url:alternateName:description:areaServed:email:logo:profiles:)`` builds. + /// The `@id` of the `Organization` node the site-wide initializer builds. /// - /// A page on another path that asserts a relationship to the organization — a `Person`'s `worksFor`, say — references this rather than - /// spelling the fragment a second time, so the two can never drift apart. + /// A page asserting a relationship to it — a `Person`'s `worksFor`, say — references this instead of spelling the fragment again, so the two + /// cannot drift. /// - Parameter url: the absolute URL the site is served at, as passed to that initializer. /// - Returns: the organization node's `@id`. public static func organizationID( diff --git a/Packages/Infrastructure/Tests/Cases/Public/Types/StructuredDataTests.swift b/Packages/Infrastructure/Tests/Cases/Public/Types/StructuredDataTests.swift index 26638ed..0467739 100644 --- a/Packages/Infrastructure/Tests/Cases/Public/Types/StructuredDataTests.swift +++ b/Packages/Infrastructure/Tests/Cases/Public/Types/StructuredDataTests.swift @@ -54,7 +54,7 @@ struct StructuredDataTests { url: url ) - // The helper is what another page references the organization by, so it has to name the node this actually builds. + // Another page references the organization by this, so it must name the node the initializer actually builds. #expect(StructuredData.organizationID(forSiteURL: url) == "https://site.example/#organization") #expect(data.payload.contains(##""@id":"\##(StructuredData.organizationID(forSiteURL: url))""##)) }