Skip to content

Conversation

evanp
Copy link
Collaborator

@evanp evanp commented Sep 19, 2025

Issue #648 points out that the reason listed in Section 2.2 for not using relative URLs is incomplete and inexact. This erratum replaces the term "JSON parser implementations" with the more general and accurate "consumers", which is used elsewhere in the document.

Issue #648 points out that the reason listed in Section 2.2 for not using relative URLs is incomplete and inexact. This erratum replaces the term "JSON parser implementations" with the more general and accurate "consumers", which is used elsewhere in the document.
@@ -4,7 +4,7 @@ This document includes errata for the [Activity Streams](https://www.w3.org/TR/a

## Activity Streams

- None yet reported.
- Section 2.2 "IRIs and URLs" says that publishers SHOULD NOT generate AS2 documents with relative IRI and URL references because JSON parser implementations may not conserve the base context to resolve relative references. This is overly specific; there are other types of implementations that may also fail to conserve the base context. One correction is to simply remove the reference to JSON parsers and replace it with "consumers": "Relative IRI (and URL) references SHOULD NOT be used within an Activity Streams 2.0 document due to the fact that many consumers are not capable of reliably preserving the base context necessary to properly resolve relative references."
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe replace "base context" with "base URI" ? As to avoid confusion with @context? So:

Suggested change
- Section 2.2 "IRIs and URLs" says that publishers SHOULD NOT generate AS2 documents with relative IRI and URL references because JSON parser implementations may not conserve the base context to resolve relative references. This is overly specific; there are other types of implementations that may also fail to conserve the base context. One correction is to simply remove the reference to JSON parsers and replace it with "consumers": "Relative IRI (and URL) references SHOULD NOT be used within an Activity Streams 2.0 document due to the fact that many consumers are not capable of reliably preserving the base context necessary to properly resolve relative references."
- Section 2.2 "IRIs and URLs" says that publishers SHOULD NOT generate AS2 documents with relative IRI and URL references because JSON parser implementations may not conserve the base context to resolve relative references. This is overly specific; there are other types of implementations that may also fail to conserve the base context. One correction is to simply remove the reference to JSON parsers and replace it with "consumers": "Relative IRI (and URL) references SHOULD NOT be used within an Activity Streams 2.0 document due to the fact that many consumers are not capable of reliably preserving the base URI necessary to properly resolve relative references."

We could also add a note that determining the base URI may have significant uncertainty between the implementations and different object structures you might receive. e.g., if an object has an @id but a relative IRI or URL with in, does that mean it's relative to that @id even if the parent object has a @base?

Copy link
Contributor

Choose a reason for hiding this comment

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

The language of "base URI" comes from RFC 3986, Section 5.2.1

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