diff options
Diffstat (limited to 'en_US/getting-files.xml')
| -rw-r--r-- | en_US/getting-files.xml | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/en_US/getting-files.xml b/en_US/getting-files.xml index 7789d4e..61f0812 100644 --- a/en_US/getting-files.xml +++ b/en_US/getting-files.xml @@ -88,14 +88,14 @@ documents for &DISTRO; users around the world. The flexibility of XML allows for a single document to be used many times for many purposes, like reusable code for a programmer.</para> - <para>DocBook is iself very well documented. For more information + <para>DocBook is itself very well documented. For more information about DocBook, visit <ulink url="http://www.docbook.org/"/>. The - DocBook site also features complete browseable and downloadable - copies of <citetitle>DocBook: The Definitive Guide</citetitle>, - the canonical source for DocBook information.</para> + DocBook site also features complete copies of <citetitle>DocBook: + The Definitive Guide</citetitle> to browse and download, the + canonical source for DocBook information.</para> <note> <title>DocBook XML Versions</title> - <para>DocBook XML, like a computer progam, has version numbers. + <para>DocBook XML, like a computer program, has version numbers. The version used by &FDP; right now is &DBVER;. The DocBook web site may document a slightly newer version, but the majority of the schema still applies.</para> @@ -149,10 +149,17 @@ documentation-guide documentation-guide &docs-common]]></computeroutput></screen linkend="ch-cvs"/>.</para> <para>Note in the listing above that the <systemitem>about-fedora</systemitem> module has two branches - avalable. One branch is for &DISTRO; 7 and one is for forward + available. One branch is for &DISTRO; 7 and one is for forward development to match the current work of developers. On the other hand, the <systemitem>documentation-guide</systemitem> module is not branched.</para> + <tip> + <title>Modules Labeled <filename>-dir</filename></title> + <para>Modules ending with the suffix <filename>-dir</filename> are + not usually helpful to checkout directly. These modules do not + include the common build tools and thus do not provide many of + the functions contributors require.</para> + </tip> <section id="ch-getting-files-naming-modules"> <title>Module Names</title> <para>Choose a module name that accurately reflects your |