[software-collections-guide: 6/17] Update prefix docs per devel's feedback

Petr Kovář pmkovar at fedoraproject.org
Fri Jul 11 16:08:41 UTC 2014


commit 4e573c2782f5bf7bcaf612f5778b20acc202c009
Author: Petr Kovar <pkovar at redhat.com>
Date:   Fri May 2 18:10:42 2014 +0200

    Update prefix docs per devel's feedback

 en-US/Packaging_Software_Collections.xml |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
---
diff --git a/en-US/Packaging_Software_Collections.xml b/en-US/Packaging_Software_Collections.xml
index 7ead3c4..a06d5d3 100644
--- a/en-US/Packaging_Software_Collections.xml
+++ b/en-US/Packaging_Software_Collections.xml
@@ -107,7 +107,7 @@
   	<itemizedlist>
   		<listitem>
   			<para>
-  				the <replaceable>provider</replaceable> part, which defines the provider name, and
+  				the <replaceable>provider</replaceable> part, which defines the provider's name, and
 			</para>
 		</listitem>
 		<listitem>
@@ -118,8 +118,9 @@
   	</itemizedlist>
   	<para>These two parts of the &DSCL; prefix are separated by an underscore (<literal>_</literal>), as in the following example:</para>
 	<programlisting>myorganization_ruby193</programlisting>
-	<para>In this example, <replaceable>myorganization</replaceable> is the provider name, and <replaceable>ruby193</replaceable> is the name of the &DSCL;.
+	<para>In this example, <replaceable>myorganization</replaceable> is the provider's name, and <replaceable>ruby193</replaceable> is the name of the &DSCL;.
 	</para>
+	<para>While it is ultimately a vendor's or distributor's decision whether to specify the provider's name in the prefix or not, specifying it is highly recommended. A notable exception are &DSCL;s provided by Red Hat, they do not specify the provider's name in their prefixes.</para>
 	</section>
 	<section id="sect-Software_Collection_Package_Names">
 		<title>&DSCL; Package Names</title>


More information about the docs-commits mailing list