diff --git a/README.adoc b/README.adoc
index 7ade3b1..cd1c370 100644
--- a/README.adoc
+++ b/README.adoc
@@ -1,6 +1,15 @@
BPMN 2.0 Extension for Envelope Decorator Bounds
================================================
+link:bpmn-envelope-decorator-bounds.xsd[XML Schema including full Documentation]
+
+link:https://falko.github.io/bpmn-extensions/envelope-decorator-bounds/bpmn-envelope-decorator-bounds.html[HTML Documentation generated from XML Schema]
+
+This XML schema defines and documents BPMN 2.0 extension elements and
+attributes to overcome limitations of BPMN Diagram Interchange.
+
+In particular, the attribute envelopeDecoratorBounds allows to interchange the position and dimensions
+of the envelope decorator on a BPMN Message Flow.
With this extension the Envelope Decorator can be freely positioned
along the Message Flow and not just in the middle of it.
@@ -8,26 +17,20 @@ image:bpmn-envelope-decorator-bounds.part.png["Envelope Decorator freely positio
link:bpmn-envelope-decorator-bounds.bpmn[Example BPMN File]
-
-This extension is defined in the namespace: http://www.omg.org/spec/BPMN/non-normative/extensions/envelope-decorator-bounds/1.0
-
-It does not come with a proper XSD since only attributes are contributed.
-
[source,xml]
----
-
-...
-
-
-
-
-
-
-
-
-
-...
-
+
+
+
+
+
+
+
+
+
+
+
+
----
## Implementers
diff --git a/bpmn-envelope-decorator-bounds.bpmn b/bpmn-envelope-decorator-bounds.bpmn
index 2775bc2..3a257a1 100644
--- a/bpmn-envelope-decorator-bounds.bpmn
+++ b/bpmn-envelope-decorator-bounds.bpmn
@@ -1622,7 +1622,12 @@
-
+
+
+
+
+
+
diff --git a/bpmn-envelope-decorator-bounds.xsd b/bpmn-envelope-decorator-bounds.xsd
new file mode 100644
index 0000000..d3a0bf0
--- /dev/null
+++ b/bpmn-envelope-decorator-bounds.xsd
@@ -0,0 +1,68 @@
+
+
+
+
+
+
+
+
+
+ This XML schema defines and documents BPMN 2.0 extension elements and
+ attributes to overcome limitations of BPMN Diagram Interchange.
+
+
+
+
+
+
+ Extension element on bpmndi:BPMNEdge that reference a bpmn:MessageFlow
+
+ BPMNEnvelopeDecorator allows to interchange the position and dimensions
+ of the Envelope Decorator on a BPMN Message Flow.
+ With this extension the Envelope Decorator can be freely positioned
+ along the Message Flow and not just in the middle of it.
+
+ BPMN 2.1, page 411 (PDF 441) says:
+ "Note that for Message Flow with an envelope decorator, the envelope
+ decorator should be at the midpoint of the message flow. BPMN DI does
+ not provide an interchange of the bounds of the envelope decorator."
+
+ Example:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ See also bpmn-envelope-decorator-bounds.png
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/test-validation-of-example.sh b/test-validation-of-example.sh
index ddecbe6..11e9df3 100755
--- a/test-validation-of-example.sh
+++ b/test-validation-of-example.sh
@@ -1,2 +1,2 @@
#!/bin/sh
-xmllint --schema 'bpmn/BPMN20.xsd' --noout bpmn-envelope-decorator-bounds.bpmn
+xmllint --schema 'bpmn/BPMN20.xsd' --schema bpmn-envelope-decorator-bounds.xsd --noout bpmn-envelope-decorator-bounds.bpmn