From 9d76d852d8ce745a5a2b2f27b48ce429f67923fa Mon Sep 17 00:00:00 2001 From: Evan Prodromou Date: Fri, 6 Dec 2024 12:35:45 -0500 Subject: [PATCH 1/3] Change normative language in Microsyntax non-normative section I changed MAY, SHOULD NOT and SHOULD to alternate phrasings that don't suggest normative language. --- ERRATA.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/ERRATA.md b/ERRATA.md index 24ed307..22fc452 100644 --- a/ERRATA.md +++ b/ERRATA.md @@ -80,3 +80,5 @@ This document includes errata for the [Activity Streams](https://www.w3.org/TR/a - Unlike `latitude` and `longitude`, the domain of the `altitude` term is the `Object` type. The `altitude` term should be included in the list of properties of an `Object`. Because `altitude` is primarily documented as a property of a `Place`, publishers should not include `altitude` on objects that are not of type `Place`, and consumers should accept objects with this property that aren't of type `Place`. - The domain of the `attributedTo` property is both `Link` and `Object`. `attributedTo` should be included in the list of properties of a `Link`. + + - The second paragraph in the non-normative section "Mentions, Tags and Other Common Social Microsyntaxes" should read, 'While such microsyntaxes can be used within the values of the `content`, `name`, and `summary` properties on an Activity Streams Object, implementations are not required to parse the values of those properties in order to determine the appropriate routing of notifications, categorization, or linking between objects. Instead, publishers make appropriate use of the vocabulary terms provided specifically for these purposes.' From ba6eb83e7476af3405eeb4644681d913ae025f70 Mon Sep 17 00:00:00 2001 From: Evan Prodromou Date: Fri, 27 Feb 2026 12:54:57 -0500 Subject: [PATCH 2/3] Clarify non-normative section on microsyntaxes Put erratum on microsyntax section into problem/possible solution format. --- ERRATA.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ERRATA.md b/ERRATA.md index 22fc452..a48fa22 100644 --- a/ERRATA.md +++ b/ERRATA.md @@ -81,4 +81,4 @@ This document includes errata for the [Activity Streams](https://www.w3.org/TR/a - The domain of the `attributedTo` property is both `Link` and `Object`. `attributedTo` should be included in the list of properties of a `Link`. - - The second paragraph in the non-normative section "Mentions, Tags and Other Common Social Microsyntaxes" should read, 'While such microsyntaxes can be used within the values of the `content`, `name`, and `summary` properties on an Activity Streams Object, implementations are not required to parse the values of those properties in order to determine the appropriate routing of notifications, categorization, or linking between objects. Instead, publishers make appropriate use of the vocabulary terms provided specifically for these purposes.' + - The second paragraph in the non-normative section "Mentions, Tags and Other Common Social Microsyntaxes" contains RFC 2119 capitalized terms like MAY, SHOULD NOT, and SHOULD, which gives the impression that the requirements are normative. One solution is to replace the capitalized terms with equivalent terms that don't suggest normative requirements: 'While such microsyntaxes can be used within the values of the `content`, `name`, and `summary` properties on an Activity Streams Object, implementations are not required to parse the values of those properties in order to determine the appropriate routing of notifications, categorization, or linking between objects. Instead, publishers make appropriate use of the vocabulary terms provided specifically for these purposes.' From 6fe3ef7c00b1accb25ad102040167edf1af0e805 Mon Sep 17 00:00:00 2001 From: Evan Prodromou Date: Fri, 20 Mar 2026 12:47:22 -0400 Subject: [PATCH 3/3] Apply suggestion from @csarven Co-authored-by: Sarven Capadisli --- ERRATA.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ERRATA.md b/ERRATA.md index a48fa22..0597734 100644 --- a/ERRATA.md +++ b/ERRATA.md @@ -81,4 +81,4 @@ This document includes errata for the [Activity Streams](https://www.w3.org/TR/a - The domain of the `attributedTo` property is both `Link` and `Object`. `attributedTo` should be included in the list of properties of a `Link`. - - The second paragraph in the non-normative section "Mentions, Tags and Other Common Social Microsyntaxes" contains RFC 2119 capitalized terms like MAY, SHOULD NOT, and SHOULD, which gives the impression that the requirements are normative. One solution is to replace the capitalized terms with equivalent terms that don't suggest normative requirements: 'While such microsyntaxes can be used within the values of the `content`, `name`, and `summary` properties on an Activity Streams Object, implementations are not required to parse the values of those properties in order to determine the appropriate routing of notifications, categorization, or linking between objects. Instead, publishers make appropriate use of the vocabulary terms provided specifically for these purposes.' + - The second paragraph in the non-normative section "Mentions, Tags and Other Common Social Microsyntaxes" contains RFC 2119 capitalized terms like MAY, SHOULD NOT, and SHOULD, which gives the impression that the requirements are normative. One solution is to replace the capitalized terms with equivalent terms that don't suggest normative requirements: 'While such microsyntaxes can be used within the values of the `content`, `name`, and `summary` properties on an Activity Streams Object, implementations cannot be expected to parse the values of those properties in order to determine the appropriate routing of notifications, categorization, or linking between objects. Instead, publishers are encouraged to make appropriate use of the vocabulary terms provided specifically for these purposes.'