summaryrefslogtreecommitdiffstats
path: root/developer-doc/phb/documentation.docbook
diff options
context:
space:
mode:
authortpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2011-07-04 22:38:03 +0000
committertpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2011-07-04 22:38:03 +0000
commitdadc34655c3ab961b0b0b94a10eaaba710f0b5e8 (patch)
tree99e72842fe687baea16376a147619b6048d7e441 /developer-doc/phb/documentation.docbook
downloadkmymoney-dadc34655c3ab961b0b0b94a10eaaba710f0b5e8.tar.gz
kmymoney-dadc34655c3ab961b0b0b94a10eaaba710f0b5e8.zip
Added kmymoney
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kmymoney@1239792 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'developer-doc/phb/documentation.docbook')
-rw-r--r--developer-doc/phb/documentation.docbook101
1 files changed, 101 insertions, 0 deletions
diff --git a/developer-doc/phb/documentation.docbook b/developer-doc/phb/documentation.docbook
new file mode 100644
index 0000000..f2ee6f2
--- /dev/null
+++ b/developer-doc/phb/documentation.docbook
@@ -0,0 +1,101 @@
+<chapter id="documentation">
+<chapterinfo>
+<authorgroup>
+<author>
+ <firstname>Tom</firstname>
+ <surname>Browder</surname>
+ <affiliation>
+ <address><email>tom.browder@gmail.com</email></address>
+ </affiliation>
+</author>
+</authorgroup>
+</chapterinfo>
+
+<title>Documentation</title>
+<para>
+Code documentation is discussed in the section "coding." This section discusses developer and user documentation and generating html and pdf versions of same. Note that all non-source-code documentation, with two exceptions, must be written in docbook form.
+<note>
+The two exceptions are
+<filename>./kmymoney2/html/home.html</filename>
+and
+<filename>./kmymoney2/html/whats_new.html</filename>
+which are used on &kappname;'s internal home page when running the application.
+</note>
+</para>
+
+<!-- =============================================== -->
+<sect1 id="documentation-general">
+<title>General</title>
+<para>In general, all documentation for &kappname; should follow guidelines for the KDE project.
+In addition to the KDE guidelines, there are &kappname; guidelines (which take precedence if there are conflicts).
+See the following KDE resources:
+</para>
+<orderedlist>
+<listitem><ulink url="http://l10n.kde.org/">http://l10n.kde.org/</ulink></listitem>
+<listitem><ulink url="http://l10n.kde.org/docs/markup/index.html">http://l10n.kde.org/docs/markup/index.html</ulink></listitem>
+<listitem><ulink url="http://l10n.kde.org/docs/tools.php">http://l10n.kde.org/docs/tools.php</ulink></listitem>
+<listitem><ulink url="http://people.fruitsalad.org/phil/kde">http://people.fruitsalad.org/phil/kde</ulink></listitem>
+<listitem><ulink url="http://people.fruitsalad.org/phil/kde/pdf-stuff/pdf-instructions.html">http://people.fruitsalad.org/phil/kde/pdf-stuff/pdf-instructions.html</ulink></listitem>
+
+</orderedlist>
+
+<para>XML entities should be used for commonly used terms and phrases. There is a &kappname; list at
+<orderedlist>
+<listitem>./developer-doc/phb/kmymoney-entities.docbook</listitem>
+</orderedlist>
+</para>
+
+
+</sect1>
+
+
+<!-- =============================================== -->
+<sect1 id="documentation-entities">
+<title>Style Guide</title>
+</sect1>
+
+<!-- =============================================== -->
+<sect1 id="documentation-tools">
+<title>Tools</title>
+<orderedlist>
+<listitem>meinproc (used to produce HTML from docbook; part of KDE base)</listitem>
+<listitem>dblatex (used to produce PDF from docbook; add-on from KDE doc team; see resources)</listitem>
+<listitem>??check?? (used to check docbook formatting, etc.; part of KDE base)</listitem>
+<listitem>??check?? (used to check consistency of word and phrase usage; add-on from KDE doc team; see resources)</listitem>
+</orderedlist>
+</sect1>
+
+<!-- =============================================== -->
+<sect1 id="documentation-style-guide">
+<title>Style Guide</title>
+</sect1>
+
+
+
+<!-- =============================================== -->
+<sect1 id="documentation-making-docs">
+<title>Producing Final Documents</title>
+
+<sect2 id="documentation-making-html">
+<title>HTML</title>
+<example>
+<title>Using include stoppers</title>
+<screen>
+
+ (command)
+</screen>
+</example>
+</sect2>
+
+<sect2 id="documentation-making-pdf">
+<title>PDF</title>
+</sect2>
+
+<sect2 id="documentation-making-man">
+<title>Man Pages (UNIX only)</title>
+</sect2>
+
+</sect1>
+
+</chapter>
+