Improve sequence extension documentation

Signed-off-by: Yordis Prieto <[email protected]>

fixes #1366

Author: yordis

cloudevents/extensions/sequence.md

@@ -14,6 +14,12 @@ value comes first.
 Produces and consumers are free to define an out-of-band agreement on the
 semantic meaning, or valid values, for the attribute.
 
+If sequence comparison across multiple dimensions is required (e.g., per source 
+AND subject), implementers have two options:
+- Include the additional dimension in the `source` attribute value 
+  (e.g., `"source": "https://example.com/users/service/subject123"`)
+- Define a new extension that meets their specific sequencing requirements
+
 ## Notational Conventions
 
 As with the main [CloudEvents specification](../spec.md), the key words "MUST",
@@ -31,8 +37,8 @@ this extension is being used.
 ### sequence
 
 - Type: `String`
-- Description: Value expressing the relative order of the event. This enables
-  interpretation of data supercedence.
+- Description: Value expressing the relative order of the event within the scope
+  of its `source` attribute.
 - Constraints
   - REQUIRED
   - MUST be a non-empty lexicographically-orderable string
@@ -44,3 +50,39 @@ can determine the order of the events via a simple string-compare type of
 operation. This means that it might be necessary for the value to include
 some kind of padding (e.g. leading zeros in the case of the value being the
 string representation of an integer).
+
+## Examples
+
+### Valid Usage
+
+Events from the same source with properly ordered sequences:
+
+```json
+{
+  "source": "https://example.com/users/service",
+  "sequence": "001",
+  "id": "event-1"
+}
+
+{
+  "source": "https://example.com/users/service", 
+  "sequence": "002",
+  "id": "event-2"
+}
+```
+
+The second event comes after the first (`"002" > "001"`).
+
+### Invalid Cross-Source Comparison
+
+```json
+{
+  "source": "https://example.com/users/service",
+  "sequence": "005"
+}
+
+{
+  "source": "https://example.com/orders/service",
+  "sequence": "003"
+}
+```