diff --git a/docs/libs/tmpl/gstdataprotocol.sgml b/docs/libs/tmpl/gstdataprotocol.sgml
deleted file mode 100644
index 1253a36257..0000000000
--- a/docs/libs/tmpl/gstdataprotocol.sgml
+++ /dev/null
@@ -1,266 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@GST_DP_HEADER_FLAG_NONE:
-@GST_DP_HEADER_FLAG_CRC_HEADER:
-@GST_DP_HEADER_FLAG_CRC_PAYLOAD:
-@GST_DP_HEADER_FLAG_CRC:
-
-
-
-
-
-
-@GST_DP_PAYLOAD_NONE:
-@GST_DP_PAYLOAD_BUFFER:
-@GST_DP_PAYLOAD_CAPS:
-@GST_DP_PAYLOAD_EVENT_NONE:
-
-
-
-
-
-
-
-
-
-
-
-
-
-@GST_DP_VERSION_0_2:
-@GST_DP_VERSION_1_0:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@buffer:
-@flags:
-@length:
-@header:
-@Returns:
-
-
-
-
-
-
-
-@caps:
-@flags:
-@length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@event:
-@flags:
-@length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@version:
-@header_from_buffer:
-@packet_from_caps:
-@packet_from_event:
-
-
-
-
-
-
-@version:
-@Returns:
-
-
-
-
-
-
-
-@packetizer:
-
-
-
-
-
-
-
-@buffer:
-@length:
-@Returns:
-
-
-
-
-
-
-
-@header:
-@Returns:
-
-
-
-
-
-
-
-@header:
-@Returns:
-
-
-
-
-
-
-
-@buffer:
-@flags:
-@length:
-@header:
-@Returns:
-
-
-
-
-
-
-
-@caps:
-@flags:
-@length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@event:
-@flags:
-@length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@payload:
-@Returns:
-
-
-
-
-
-
-
-@header_length:
-@header:
-@payload:
-@Returns:
-
-
diff --git a/libs/gst/dataprotocol/dataprotocol.c b/libs/gst/dataprotocol/dataprotocol.c
index 74da67f855..fa07d0cab9 100644
--- a/libs/gst/dataprotocol/dataprotocol.c
+++ b/libs/gst/dataprotocol/dataprotocol.c
@@ -42,6 +42,12 @@
* stream. This implies that there will always be a caps packet before any
* buffer packets.
*
+ * The versioning of the protocol is independent of GStreamer's version.
+ * The major number gets incremented, and the minor reset, for incompatible
+ * changes. The minor number gets incremented for compatible changes that
+ * allow clients who do not completely understand the newer protocol version
+ * to still decode what they do understand.
+ *
* Version 0.2 serializes only a small subset of all events, with a custom
* payload for each type. Also, all GDP streams start with the initial caps
* packet.