docs: Recommend using rDNS strings as developer-ID

ximion · Feb 19, 2024 · 4537dce · 4537dce
1 parent 06eb000
commit 4537dce
Showing 1 changed file with 2 additions and 2 deletions.
diff --git 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