diff --git a/docs/xml/metainfo-component.xml b/docs/xml/metainfo-component.xml
index 77e7a76e..9e7af224 100644
--- a/docs/xml/metainfo-component.xml
+++ b/docs/xml/metainfo-component.xml
@@ -1168,8 +1168,8 @@
 			The <code>&lt;developer/&gt;</code> element is designed to represent the developers or project responsible for development of the project described in the metadata.
 		</para>
 		<para>
-			The element should have a <literal>id</literal> property, containing a unique ID to identify the respective developer. It is recommended to use a web URL,
-			like <code>gnome.org</code> as ID to achieve a higher chance of uniqueness.
+			The element should have a <literal>id</literal> property, containing a unique ID to identify the respective developer. It is recommended to use a reverse-DNS
+			name, like <code>org.gnome</code> or <code>com.github.ximion</code>, as ID to achieve a higher chance of uniqueness.
 		</para>
 		<para>
 			Every <literal>developer</literal> element must have a <literal>name</literal> tag as child, which contains a translatable name for the