language

README.md

@@ -175,10 +175,10 @@ The following tags are being actively considered for adoption into the namespace
 
 ```xml
 <podcast:socialInteract
-  protocol="[slug of social protocol being used(slug]]"
-  priority="[the order of rendering(int)]"
+  protocol="[slug of social protocol being used(slug)]"
   accountId="[account id of posting party(string)]"
   accountUrl="[url to posting party's platform profile(string)]"
+  priority="[the order of rendering(int)]"
 >
 [url of root post/comment(string)]
 </podcast:socialInteract>
@@ -192,7 +192,7 @@ The following tags are being actively considered for adoption into the namespace
 
 This element allows a podcaster to attach the "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 it from the app itself.
+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 `<podcast:socialInteract>` tags are given for an `<item>`, the `priority` attribute is strongly recommended to give the app an indication as to which comments to
 display first.
@@ -202,9 +202,9 @@ of "disabled" can be specified, with no other attributes or node value present.
 
 #### Attributes
  - **protocol** (required) The [protocol](socialprotocols.txt) in use for interacting with the comment root post.
- - **accountId** (recommended) The account id of the account that posted this root post.
- - **accountUrl** (optional) The public url of the account.
- - **priority** (optional) When multiple socialInteract tags are present, this integer gives order or priority in ascending order of importance.
+ - **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