Improved wordings

Author: scammo

packages/vocab-tools/src/__snapshots__/class.test.ts.deno.snap

@@ -31029,8 +31029,10 @@ satisfies?: URL | null;resourceQuantity?: Measure | null;}
   }
 
 /** The {@link Intent} of a {@link Proposal} that this commitment
- * satisfies.  The value is typically a fragment identifier such as
- * \`#primary\` or \`#reciprocal\`.
+ * satisfies.  The value is the proposal's URI with a
+ * [fragment](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Fragment)
+ * appended to identify the intent.  Recommended fragments are
+ * \`primary\` and\`reciprocal\`.
  * 
  */
  get satisfies(): (URL | null) {

packages/vocab-tools/src/__snapshots__/class.test.ts.node.snap

@@ -31027,8 +31027,10 @@ satisfies?: URL | null;resourceQuantity?: Measure | null;}
   }
 
 /** The {@link Intent} of a {@link Proposal} that this commitment
- * satisfies.  The value is typically a fragment identifier such as
- * \`#primary\` or \`#reciprocal\`.
+ * satisfies.  The value is the proposal's URI with a
+ * [fragment](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Fragment)
+ * appended to identify the intent.  Recommended fragments are
+ * \`primary\` and\`reciprocal\`.
  * 
  */
  get satisfies(): (URL | null) {

packages/vocab-tools/src/__snapshots__/class.test.ts.snap

@@ -31029,8 +31029,10 @@ satisfies?: URL | null;resourceQuantity?: Measure | null;}
   }
 
 /** The {@link Intent} of a {@link Proposal} that this commitment
- * satisfies.  The value is typically a fragment identifier such as
- * \`#primary\` or \`#reciprocal\`.
+ * satisfies.  The value is the proposal's URI with a
+ * [fragment](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Fragment)
+ * appended to identify the intent.  Recommended fragments are
+ * \`primary\` and\`reciprocal\`.
  * 
  */
  get satisfies(): (URL | null) {

packages/vocab/src/commitment.yaml

@@ -27,8 +27,10 @@ properties:
   uri: "https://w3id.org/valueflows/ont/vf#satisfies"
   description: |
     The {@link Intent} of a {@link Proposal} that this commitment
-    satisfies.  The value is typically a fragment identifier such as
-    `#primary` or `#reciprocal`.
+    satisfies.  The value is the proposal's URI with a
+    [fragment](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Fragment)
+    appended to identify the intent.  Recommended fragments are
+    `primary` and`reciprocal`.
   range:
   - "http://www.w3.org/2001/XMLSchema#anyURI"
 

packages/vocab/src/vocab.test.ts

@@ -2909,8 +2909,8 @@ test("FEP-0837: Agreement roundtrip with both commitments", async () => {
   );
 });
 
-test("FEP-0837: Agreement parses verbatim Accept-result example from spec", async () => {
-  // Verbatim from FEP-0837 "Accepting an agreement" example.
+test("FEP-0837: Agreement parses Accept-result example adapted from spec", async () => {
+  // Adapted from FEP-0837's "Accepting an agreement" example, to Fedify customization
   const json = {
     "@context": [
       "https://www.w3.org/ns/activitystreams",