diff --git a/docs/1.0.md b/docs/1.0.md index fb87ae4..3efa56c 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -872,3 +872,50 @@ The node value is a free form string meant to explain to the user where this con ```xml Chat on Twitter! ``` + + + +



+## Social Interact +``

+The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode. This "root post" +is treated as the canonical location of where the comments and discussion around this episode will take place. This can be thought +of as the "official" social media comment space for this episode. If a protocol such as "activitypub" is used, or some other +protocol that allows programmatic API access, these comments can be directly pulled into the app, and replies can be posted back to +the thread from the app itself. + +If multiple `socialInteract` tags are given for an ``, the `priority` attribute is strongly recommended to give the app an +indication as to which comments to display first. + +This tag can also be used as a signal to platforms and apps that the podcaster does not want public comments shown alongside this +episode. For this purpose a `protocol` value of "disabled" can be specified, with no other attributes or node value present. + +### Parent +  `` + +### Count +  Multiple + +### Attributes +- **uri** (required) The uri/url of root post comment. +- **protocol** (required) The [protocol](/socialprotocols.txt) in use for interacting with the comment root post. +- **accountId** (recommended) The account id (on the commenting platform) of the account that created this root post. +- **accountUrl** (optional) The public url (on the commenting platform) of the account that created this root post. +- **priority** (optional) When multiple socialInteract tags are present, this integer gives order or priority in ascending order of importance. A lower number means higher priority. + + +Example (simple): +```xml + +``` + +Example (complex): +```xml + + +``` + +Example (disabled): +```xml + +``` \ No newline at end of file