dgv2/en_US entering-project.xml,1.1,1.2
by fedora-docs-commits@redhat.com
Author: kwade
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1382/en_US
Modified Files:
entering-project.xml
Log Message:
Making internal containers for the content, that can wrap some understanding around where the user is going to. This is different than just linking to those pages, but still leaves them canonical. Right?
Index: entering-project.xml
===================================================================
RCS file: /cvs/docs/dgv2/en_US/entering-project.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- entering-project.xml 2 Jun 2006 05:16:13 -0000 1.1
+++ entering-project.xml 2 Jun 2006 06:19:36 -0000 1.2
@@ -13,35 +13,63 @@
<chapter id="entering-project">
<title>Entering the &FDP;</title>
<abstract>
- <para>This chapter covers the five steps to joining the &FDP;:
+ <para>This chapter covers the following steps to joining the &FDP;:
+ </para>
<orderedlist>
<listitem>
- <para>Creating a GPG key</para>
+ <para><ulink
+ url="http://fedoraproject.org/wiki/DocsProject/UsingGpg/CreatingKeys">Creating
+ a GPG key</ulink> [<xref
+ linkend="sn-entering-project-gpg"/>More ..<ulink>]</para>
</listitem>
<listitem>
- <para>Joining the mailing list</para>
+ <para><ulink
+ url="http://www.redhat.com/mailman/listinfo/fedora-docs-list/">Joining the mailing list</ulink> [<xref
+ linkend="sn-entering-project-docs-list"/>More ..<ulink>]</para>
</listitem>
<listitem>
- <para>Creating a Wiki account</para>
+ <para><ulink url="http://fedoraproject.org/wiki/WikiEditing?">Creating a Wiki account</ulink> [<xref
+ linkend="sn-entering-project-wiki"/>More ..<ulink>]</para>
</listitem>
<listitem>
- <para>(Optional) Creating a SSH key</para>
+ <para><ulink url="http://fedoraproject.org/wiki/Cryptography">Creating an SSH key</ulink> [<xref
+ linkend="sn-entering-project-ssh-key"/>More ..<ulink>]</para>
</listitem>
<listitem>
- <para>(Optional) Creating a Bugzilla account</para>
+ <para>(Optional) Creating a Bugzilla account [<xref
+ linkend="sn-entering-project-bugzilla"/>More ..<ulink>]</para>
</listitem>
<listitem>
- <para>(Optional) Getting a CVS account</para>
+ <para>(Optional) <ulink
+ url="http://fedoraproject.org/wiki/DocsProject/CvsUsage">Getting a CVS account</ulink> [<xref
+ linkend="sn-entering-project-cvs"/>More ..<ulink>]</para>
</listitem>
</orderedlist>
</para>
</abstract>
- <section id="creating-gpg-keys" lang="">
+ <section id="sn-entering-project-gpg">
+ <title>Creating a GPG key</title>
+ <para>
+
+ </para>
+ </section>
+
+ <section id="sn-entering-project-docs-list">
+ <title>Joining fedora-docs-list</title>
+ <para>
+ </para>
+ </section>
+ <section id="sn-entering-project-wiki">
+ <title>Creating a Wiki account</title>
+ <para>
+
+ </para>
+ </section>
<section id="creating-ssh-keys">
<title>Creating SSH Keys</title>
- <para>
+ <para></ulink>
<firstterm>Secure Shell</firstterm>, or <acronym>SSH</acronym>, is
a way for a user to communicate securely with a host. SSH uses
very secure cryptographic routines to make your communications
@@ -49,9 +77,20 @@
recipient. To ensure you can trust the information you receive
from &FP; servers, we recommend you create a keypair.
</para>
- </section>
+ </section>
+
+ <section id="sn-entering-project-bugzilla">
+ <title>Creating a Bugzilla account</title>
+ <para>
+ </para>
+ </section>
+ <section id="sn-entering-project-cvs">
+ <title>Getting a CVS account</title>
+ <para>
+ </para>
+ </section>
<!--
Local variables:
17 years, 11 months
dgv2/en_US lifecycle.xml,NONE,1.1 tools.xml,NONE,1.1
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1344
Added Files:
lifecycle.xml tools.xml
Log Message:
Add dummy XML files for later additions
--- NEW FILE lifecycle.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [
<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;
]>
<chapter id="lifecycle">
<title>Lifecycle</title>
<para>dummy</para>
</chapter>
<!--
Local variables:
mode: xml
fill-column: 72
End:
-->
--- NEW FILE tools.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [
<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;
]>
<chapter id="tools">
<title>Tools</title>
<para>dummy</para>
</chapter>
<!--
Local variables:
mode: xml
fill-column: 72
End:
-->
17 years, 11 months
dgv2/en_US creating-document.xml,NONE,1.1
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1321
Added Files:
creating-document.xml
Log Message:
Add beginning of creating-document file
--- NEW FILE creating-document.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [
<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;
]>
<chapter id="creating-document">
<title>Creating a Document in &SCM;</title>
<para>
The &FDP; uses a standard organization for its work in &SCM;. This
organization promotes ease of use for writers, editors, and
publishers. Each document in the &FDP; &SCM; system resides in its
own separate directory, or <firstterm>module</firstterm>, named
after the content. Each module contains a number of required files
which allow contributors to ensure the document can be easily built
and published. To create a new document, simply follow these steps.
</para>
<procedure>
<step>
<title>Checking Out Common Tools</title>
<para>
The <filename class="directory">docs-common</filename> module in
&SCM; contains essential tools and support files. To create a
new document, make a work area and check out this module on your
local system:
</para>
<screen>
<command>mkdir ~/fdp</command>
<command>cd ~/fdp</command>
<command>&SCM-CMD; -d &SCM-ROOT; co docs-common</command>
</screen>
</step>
<step>
<title>Creating a Module Directory</title>
<para>
Use a descriptive name, but do not use the word "&FED;" in your
module's name. The following module names are good usage
examples:
</para>
<itemizedlist>
<listitem>
<para>
<filename class="directory">example-tutorial</filename>
</para>
</listitem>
<listitem>
<para>
<filename class="directory">system-planning-guide</filename>
</para>
</listitem>
</itemizedlist>
</step>
</procedure>
</chapter>
<!--
Local variables:
mode: xml
fill-column: 72
End:
-->
17 years, 11 months
dgv2/en_US doc-entities.xml,1.2,1.3
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1297
Modified Files:
doc-entities.xml
Log Message:
Add entity for SCM root location
Index: doc-entities.xml
===================================================================
RCS file: /cvs/docs/dgv2/en_US/doc-entities.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- doc-entities.xml 2 Jun 2006 05:39:45 -0000 1.2
+++ doc-entities.xml 2 Jun 2006 06:09:04 -0000 1.3
@@ -36,6 +36,10 @@
<comment>CLI command for SCM system</comment>
<text><command>cvs</command></text>
</entity>
+ <entity name="SCM-ROOT">
+ <comment>Root location for SCM files</comment>
+ <text>:ext:<replaceable>username</replaceable>@cvs.fedora.redhat.com:/cvs/docs</text>
+ </entity>
</group>
</entities>
17 years, 11 months
dgv2/en_US doc-entities.xml,1.1,1.2
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31375
Modified Files:
doc-entities.xml
Log Message:
Add entities for SCM system
Index: doc-entities.xml
===================================================================
RCS file: /cvs/docs/dgv2/en_US/doc-entities.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- doc-entities.xml 2 Jun 2006 05:16:13 -0000 1.1
+++ doc-entities.xml 2 Jun 2006 05:39:45 -0000 1.2
@@ -27,4 +27,20 @@
<text>5</text>
</entity>
</group>
+ <group name="SCM">
+ <entity name="SCM">
+ <comment>Type of source code management system for FDP</comment>
+ <text>CVS</text>
+ </entity>
+ <entity name="SCM-CMD">
+ <comment>CLI command for SCM system</comment>
+ <text><command>cvs</command></text>
+ </entity>
+ </group>
</entities>
+
+<!--
+Local variables:
+mode: xml
+End:
+-->
17 years, 11 months
dgv2/en_US doc-entities.xml, NONE, 1.1 documentation-guide.xml, NONE, 1.1 entering-project.xml, NONE, 1.1 fdp-info.xml, NONE, 1.1
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31291/dgv2/en_US
Added Files:
doc-entities.xml documentation-guide.xml entering-project.xml
fdp-info.xml
Log Message:
Add starting content for dgv2
--- NEW FILE doc-entities.xml ---
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE entities SYSTEM "../../docs-common/common/entities/entities.dtd">
<entities>
<title>Local entities for Mirror Tutorial</title>
<group name="Document revision markings">
<entity name="DOCNAME">
<comment>Document name</comment>
<text>documentation-guide</text>
</entity>
<entity name="DOCVERSION">
<comment>Version number</comment>
<text>0.9.0</text>
</entity>
<entity name="DOCDATE">
<comment>Date of last revision</comment>
<text>2006-06-01</text>
</entity>
<entity name="DOCID">
<comment>Document ID</comment>
<text><use entity="DOCNAME"/>-<use entity="DOCVERSION"/> (<use
entity="DOCDATE"/>)</text>
</entity>
</group>
<group name="Miscellaneous">
<entity name="FCLOCALVER">
<comment>Local version of Fedora Core for this document</comment>
<text>5</text>
</entity>
</group>
</entities>
--- NEW FILE documentation-guide.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [
<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;
]>
<book id="documentation-guide">
<xi:include href="fdp-info.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:fallback>
<para>fdp-info.xml file is missing!</para>
</xi:fallback>
</xi:include>
<xi:include href="entering-project.xml"
xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:fallback>
<para>entering-project.xml file is missing!</para>
</xi:fallback>
</xi:include>
<xi:include href="tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:fallback>
<para>tools.xml file is missing!</para>
</xi:fallback>
</xi:include>
<xi:include href="lifecycle.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:fallback>
<para>lifecycle.xml file is missing!</para>
</xi:fallback>
</xi:include>
<xi:include href="creating-document.xml"
xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:fallback>
<para>creating-document.xml is missing!</para>
</xi:fallback>
</xi:include>
</book>
--- NEW FILE entering-project.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [
<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;
<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;
]>
<chapter id="entering-project">
<title>Entering the &FDP;</title>
<abstract>
<para>This chapter covers the five steps to joining the &FDP;:
<orderedlist>
<listitem>
<para>Creating a GPG key</para>
</listitem>
<listitem>
<para>Joining the mailing list</para>
</listitem>
<listitem>
<para>Creating a Wiki account</para>
</listitem>
<listitem>
<para>(Optional) Creating a SSH key</para>
</listitem>
<listitem>
<para>(Optional) Creating a Bugzilla account</para>
</listitem>
<listitem>
<para>(Optional) Getting a CVS account</para>
</listitem>
</orderedlist>
</para>
</abstract>
<section id="creating-gpg-keys" lang="">
<section id="creating-ssh-keys">
<title>Creating SSH Keys</title>
<para>
<firstterm>Secure Shell</firstterm>, or <acronym>SSH</acronym>, is
a way for a user to communicate securely with a host. SSH uses
very secure cryptographic routines to make your communications
unreadable by anyone on a network other than the intended
recipient. To ensure you can trust the information you receive
from &FP; servers, we recommend you create a keypair.
</para>
</section>
<!--
Local variables:
mode: xml
fill-column: 72
End:
-->
--- NEW FILE fdp-info.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!--
Warning! Warning! Danger, Will Robinson!
This is a generated file, produced from information in
the "rpm-info.xml" file.
DO NOT EDIT THIS FILE DIRECTLY!
Edit "rpm-info.xml" to change this information.
-->
<bookinfo>
<title>Fedora Documentation Guide</title>
<copyright>
<year>2006</year>
<holder>Paul W. Frields</holder>
</copyright>
<authorgroup>
<author>
<surname>Frields</surname>
<firstname>Paul</firstname>
<othername>W.</othername>
</author>
</authorgroup>
<revhistory>
<revision>
<revnumber>0.9.0</revnumber>
<date>2006-06-01</date>
<authorinitials>PWF</authorinitials>
<revdescription>
<para>
First draft
</para>
</revdescription>
</revision>
</revhistory>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="/home/pfrields/fedora/docs/dgv2/../docs-common/common/legalnotice-opl-en_US.xml"/>
</bookinfo>
17 years, 11 months
dgv2 Makefile,NONE,1.1 rpm-info.xml,NONE,1.1
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31291/dgv2
Added Files:
Makefile rpm-info.xml
Log Message:
Add starting content for dgv2
--- NEW FILE Makefile ---
########################################################################
# NOTICE
#-----------------------------------------------------------------------
# There is actually no "de" translation. All the '*de*" files are just
# fodder to check the internationalization (i18n) workings for the FTP.
# No discourtesy to any German speaker is intended. -- Tommy Reynolds
# Actual translations welcome.
########################################################################
########################################################################
# Fedora Documentation Project Per-document Makefile
# License: GPL
# Copyright 2005,2006 Tommy Reynolds, MegaCoder.com
########################################################################
#
# Document-specific definitions.
#
DOCBASE = documentation-guide
PRI_LANG = en_US
OTHERS =
# If ${DOC_ENTITIES} is defined, ${PRI_LANG}/${DOC_ENTITIES}.xml
# must contain a complete XML file conforming to the DTD located
# in the "docs-common/common/entities/entities.dtd" file. Do NOT
# reference this file in the XMLFILES_template below.
DOC_ENTITIES = doc-entities
########################################################################
# List each XML file of your document in the template below. Append the
# path to each file to the "XMLFILES-${1}" string. Use a backslash if you
# need additional lines. Here, we have one extra file "en/para.xml"; that
# gets written as "${1}/para.xml" because later, make(1) will need to compute
# the necesssary filenames. Oh, do NOT include "fdp-info.xml" because that's
# a generated file and we already know about that one...
define XMLFILES_template
XMLFILES-${1}= ${1}/${DOCBASE}.xml \
${1}/entering-project.xml \
${1}/tools.xml \
${1}/lifecycle.xml \
${1}/creating-document.xml
endef
#
########################################################################
include ../docs-common/Makefile.common
########################################################################
# If you want to add additional steps to any of the
# targets defined in "Makefile.common", be sure to use
# a double-colon in your rule here. For example, to
# print the message "FINISHED AT LAST" after building
# the HTML document version, uncomment the following
# line:
#${DOCBASE}/index.html::
# echo FINISHED AT LAST
########################################################################
--- NEW FILE rpm-info.xml ---
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE rpm-info SYSTEM "../docs-common/packaging/rpm-info.dtd">
<rpm-info>
<colophon>
<worker surname="Frields" firstname="Paul" othername="W." id="PaulWFrields" email="stickster(a)gmail.com" wholename="Paul W. Frields" initials="PWF"/>
</colophon>
<author worker="PaulWFrields"/>
<license>
<rights>OPL</rights>
<version>1.0</version>
</license>
<copyright>
<year>2006</year>
<holder>Paul W. Frields</holder>
</copyright>
<titles>
<translation lang="en_US">
<title>Fedora Documentation Guide</title>
<desc>How to participate in documenting Fedora</desc>
</translation>
</titles>
<changelog order="newest-first">
<revision date="2006-06-01" number="0.9.0" role="doc">
<author worker="PaulWFrields"/>
<details lang="en_US">First draft</details>
</revision>
</changelog>
</rpm-info>
17 years, 11 months
dgv2/po - New directory
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/po
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31249/dgv2/po
Log Message:
Directory /cvs/docs/dgv2/po added to the repository
17 years, 11 months
dgv2/en_US - New directory
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31249/dgv2/en_US
Log Message:
Directory /cvs/docs/dgv2/en_US added to the repository
17 years, 11 months
dgv2 - New directory
by fedora-docs-commits@redhat.com
Author: pfrields
Update of /cvs/docs/dgv2
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31226/dgv2
Log Message:
Directory /cvs/docs/dgv2 added to the repository
17 years, 11 months