summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-01-21 11:00:51 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-01-21 11:00:51 (GMT)
commit48b3fbffd5b6f598a80cde7386a95cddf49bc69b (patch)
tree77134e517a8dd4f46f2426082918f16e32198d1d
parent0f945626cafccb377d02f848c2a65b8d02866322 (diff)
downloadkolab-docs-48b3fbffd5b6f598a80cde7386a95cddf49bc69b.tar.gz
Add the Common_Content files (they're essential for building, you know)
-rw-r--r--Common_Content/en-US/sect-About_Kolab_Groupware.xml68
-rw-r--r--Common_Content/en-US/sect-Feedback.xml77
-rw-r--r--Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml82
3 files changed, 227 insertions, 0 deletions
diff --git a/Common_Content/en-US/sect-About_Kolab_Groupware.xml b/Common_Content/en-US/sect-About_Kolab_Groupware.xml
new file mode 100644
index 0000000..212023a
--- /dev/null
+++ b/Common_Content/en-US/sect-About_Kolab_Groupware.xml
@@ -0,0 +1,68 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="sect-About_Kolab_Groupware">
+ <title>About Kolab Groupware</title>
+ <para>
+ Kolab is a Groupware Solution for Emails, Appointments, Contacts and more. It supports mixed client environments (Outlook/KDE) because of an open storage format. Any email client speaking standard protocols can be served.
+ </para>
+ <section id="sect-About_Kolab_Groupware-Free_Software_Components">
+ <title>Free Software Components</title>
+ <para>
+ TODO: Come on, be a little more verbose...
+ </para>
+ <section id="sect-Free_Software_Components-This_documentation">
+ <title>This documentation</title>
+ <para>
+ Describe how this documentation can be modified to custom, internal documentation
+ </para>
+
+ </section>
+
+
+ </section>
+
+ <section id="sect-About_Kolab_Groupware-Kolab_Groupware_Flavors">
+ <title>Kolab Groupware Flavors</title>
+ <para>
+ Kolab Groupware comes in two major flavors:
+ </para>
+ <para>
+ <orderedlist>
+ <listitem>
+ <formalpara id="form-Kolab_Groupware_Flavors-Kolab_Vanilla">
+ <title>Kolab (<emphasis>Vanilla</emphasis>)</title>
+ <para>
+ The vanilla flavor of Kolab is ideally suited for general purpose Groupware systems in which no specialist features are required.
+ </para>
+
+ </formalpara>
+
+ </listitem>
+ <listitem>
+ <formalpara id="form-Kolab_Groupware_Flavors-Hosted_Kolab">
+ <title>Hosted Kolab</title>
+ <para>
+ Hosted Kolab is the flavor targeted specifically at hosting providers (ISP, ASP, Cloud) offering Kolab Groupware environments to multiple customers, possibly through multiple resellers.
+ </para>
+
+ </formalpara>
+
+ </listitem>
+
+ </orderedlist>
+
+ </para>
+ <para>
+ Furthermore, the Kolab software are divided in a community version, and an enterprise version. The community version naturally moves forward a little faster and is subject to change a lot more so then the enterprise version. The community version of a product series will only become available as an enterprise version after thorough Quality Assurance and Certification of partner products.
+ </para>
+
+ </section>
+
+ <xi:include href="sect-Supported_Platforms_and_System_Requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</section>
+
+
diff --git a/Common_Content/en-US/sect-Feedback.xml b/Common_Content/en-US/sect-Feedback.xml
new file mode 100644
index 0000000..b160dfd
--- /dev/null
+++ b/Common_Content/en-US/sect-Feedback.xml
@@ -0,0 +1,77 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<section lang="en-US" id="sect-Feedback">
+ <title>Feedback</title>
+ <indexterm>
+ <primary>feedback</primary>
+ <secondary>contact information for this manual</secondary>
+
+ </indexterm>
+ <para>
+ We value feedback on our software as well as our documentation. Please find ways to contact us in this section.
+ </para>
+
+ <section id="sect-Feedback-Reporting_Bugs_in_Kolab">
+ <title>Reporting Bugs in Kolab</title>
+ <para>
+ Bug reports can be logged in our <ulink url="https://bugzilla.kolabsys.com">Bugzilla issue tracker</ulink>. Please bear in mind registration is required.
+ </para>
+ <para>
+ When reporting a bug, please prepare to provide the following information;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Your platform, and if applicable, your distribution and the distribution version.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The version(s) of the Kolab component(s) you are using.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If a custom version is used, any options that may have specified during the build process.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ provide some text on logging a new ticket in our bugzilla, information to provide, etc. Possibly mention the life cycle of a product version series.
+ </para>
+ </section>
+
+ <section id="sect-Feedback-Mailing_Lists">
+ <title>Mailing Lists</title>
+ <para>
+ For users of Kolab software, we run a public mailing list at <ulink url="https://lists.kolab.org/mailman/listinfo/kolab-users" />. To subscribe to the list, either click the aforementioned link and fill out the information requested, or send an email to <ulink url="mailto:kolab-users-subscribe@kolab.org">kolab-users-subscribe@kolab.org</ulink>.
+ </para>
+
+ <formalpara>
+ <title>Development Mailing List</title>
+ <para>
+ For developers of Kolab software, as well as general discussion on bugs and patches, we run a public mailing list at <ulink url="https://lists.kolab.org/mailman/listinfo/kolab-devel" />. To subscribe to the list and fill out the information requested, or send an email to <ulink url="mailto:kolab-devel-subscribe@kolab.org">kolab-devel-subscribe@kolab.org</ulink>.
+ </para>
+ </formalpara>
+
+ <section id="sect-Feedback-Mailing_Lists-Archives">
+ <title>Archives</title>
+ <para>
+ The archives of both the user support and development discussion mailing list are available through web archives.
+ </para>
+ </section>
+
+ </section>
+
+ <section id="sect-Feedback-IRC">
+ <title>IRC</title>
+ <para>
+ Refer to irc://irc.freenode.net/kolab here.
+ </para>
+ </section>
+
+</section>
+
+
diff --git a/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml b/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml
new file mode 100644
index 0000000..b27c32f
--- /dev/null
+++ b/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml
@@ -0,0 +1,82 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Deployment_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="sect-Supported_Platforms_and_System_Requirements">
+ <title>Supported Platforms and System Requirements</title>
+ <para>
+ Kolab Groupware is supported on the following platforms;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ All reasonably recent versions of Linux<footnote> <para>
+ By reasonably recent versions of Linux, we intend to indicate the Cyrus project can keep up with the latest distribution release ear-marked stable.
+ </para>
+ </footnote>, including but not limited to the following distributions, in no particular order other then alphabetic;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://centos.org">CentOS</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://debian.org">Debian</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://fedoraproject.org">Fedora</ulink>
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://gentoo.org">Gentoo</ulink>
+ </para>
+ </listitem>
+-->
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://opensuse.org">openSUSE</ulink>
+ </para>
+ </listitem>
+-->
+ <listitem>
+ <para>
+ <ulink url="http://redhat.com">Red Hat Enterprise Linux</ulink>
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://www.novell.com/linux">SUSE Linux</ulink>
+ </para>
+ </listitem>
+-->
+ </itemizedlist>
+ </para>
+ <para>
+ Should your Linux distribution not be listed here, please refer to <xref linkend="sect-Feedback" /> for ways of contacting the Kolab Development team.
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ Solaris
+ </para>
+ </listitem>
+-->
+ </itemizedlist>
+ </para>
+ <remark>
+ Obviously, the list is not complete
+ </remark>
+
+</section> \ No newline at end of file