<section id="ug_project_forums">
	<title>Forums</title>
	<para>
		Every project can have its own discussion forums. When a new project is created, 3 forums are automatically created:
	</para>
	<variablelist>
		<varlistentry>
			<term>Open Discussion</term>
			<listitem>
				<para>A place where to discuss about everything.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>Help</term>
			<listitem>
				<para>A forum where to ask for help.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>Developers</term>
			<listitem>
				<para>A place where developers discuss about developments.</para>
			</listitem>
		</varlistentry>
	</variablelist>
	<section id="ug_project_forums_create_new">
		<title>Creating a new forum</title>
		<para>
			New forums can be created using the Admin section of the forum. When a new forum is created, you must insert a name of the forum, the description of the forum, select if the forum is public or private and if anonymous posts are allowed on the forum.
		</para>
		<para>
			Private forums are visible only to project members. If Anonymous posts are enabled, everybody can post messages to the forum, even users that are not logged in.
		</para>
		<para>
			You can also insert an email address where all posts will be sent.
		</para>
	</section>
	<section id="ug_project_forums_use">
		<title>Using the forum</title>
		<para>
			When you click on the name of the forum, you go to the detail of the forum.
		</para>
                <section id="ug_project_forums_select_visualization_mode">
                     <title>Selecting visualization mode</title>
		<para>
			You can select the following types of visualization for the forum lists:
		</para>
		<variablelist>
			<varlistentry>
				<term>Nested</term>
				<listitem>
					<para>Shows the messages ordered by thread. All data of the message, including the posted message itself will be visualized.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Flat</term>
				<listitem>
					<para>Similar to Nested, the messages will be showed in chronological order.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Threaded</term>
				<listitem>
					<para>Shows only title, author and date of each message. Shows the messages in threaded order. Clicking on the title of the message the entire message will be displayed.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Ultimate</term>
				<listitem>
					<para>Shows only the <quote>topic started</quote> messages. Topic starters are the messages that starts a new thread.</para>
				</listitem>
			</varlistentry>
		</variablelist>
		<para>
			You can select the number of messages for every page: 25, 50, 75 or 100.
		</para>
                </section>
                <section id="ug_project_forums_write_message">
                     <title>Writing a message</title>
                     <note>
                         <para>You can use the plain text editor or the enhanced editor to
                               compose your messages. The enhanced editor is available if the
                               WYSIWYG HTML editor plugin was enabled by project administrators.
                         </para>
                     </note>
                     <para>You can start a new thread by clicking on <guimenuitem>Start New Thread</guimenuitem>
                           link.</para>
                     <para>You can write a message in an existing thread by clicking on the
                           <guimenuitem>Reply</guimenuitem> link of an existing message.</para>
                     <para>In both cases, the enhanced editor is available to compose the message.
                           Use the tool bar to format your message.</para>
                     <para>You can modify an existing message by clicking on the <guimenuitem>Edit</guimenuitem>
                           icon.</para>
                </section>
                <section id="ug_project_forums_add_file">
                     <title>Adding a file to a message</title>
                     <para>You can add a file to an existing message by clicking on the <guimenuitem>Add</guimenuitem>
                           icon. Only one file can be attached to a given message. If you add another file,
                           the first one will be deleted.</para>
                     <para>The file must not be an executable file (.exe) and must not exceed a certain size.</para>
	        </section>
	</section>
	<section id="ug_project_forums_options">
		<title>Available options</title>
		<para>
			The forums have 2 very powerful options:
		</para>
		<variablelist>
			<varlistentry>
				<term>Save place</term>
				<listitem>
					<para>This function registers the number of messages already inserted in the forum and will highlight new messages the next time you return to the forum.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Monitor forum</term>
				<listitem>
					<para>You can select to monitor the forum by clicking on the <emphasis>Monitor Forum</emphasis> button.</para>
					<para>If this option is enabled, every post to the forum will be sent to you by email. This allows you to be informed about new messages without being logged on to FusionForge. The name of the monitored forum will appear in the users homepage in the section Monitored Forums.</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</section>
	<section id="ug_project_forums_admin">
		<title>Forum admin</title>
		<para>
			Clicking on the <guimenuitem>Forum Admin</guimenuitem> link presents you with links to <guimenuitem>Add Forum</guimenuitem> and <guimenuitem>Manage Pending Messages</guimenuitem>.
		</para>
                <para>
                        Under these links, you have a list of the forums, with for each forum a link
                        <guimenuitem>Monitoring Users</guimenuitem>. Clicking on this link will give
                        the list of users that monitor this forum.
                </para>
		<section id="ug_project_forums_add_forum">
			<title>Add Forum</title>
			<para>
				This allows you to add a new discussion forum. You can select if it is public or private (only members of the project can see it).
			</para>
		</section>
                <section id="ug_project_forums_manage_pending_messages">
                        <title>Manage Pending Messages</title>
                        <para>
                                This allows you to accept or reject messages posted to a
                                moderated forum.
                        </para>
                </section>
		<section id="ug_project_forums_delete_message">
			<title>Delete Message</title>
			<para>
				To delete a message (and any followups) from a forum, just display the message
                                and click on the Saint Andrew cross. A confirmation is required.
			</para>
		</section>
		<section id="ug_project_forums_adjust_features">
			<title>Adjust Forum Features</title>
			<para>
                                To adjust forum features, click on the forum name in the forum list.
				This allows you to alter the properties of the forum such as the name and description, whether or not anonymous posts are allowed, if it's public and you can enter an address to which all messages are posted.
			</para>
		</section>
                <section id="ug_project_forums_configure_moderation_level">
                        <title>Configure Forum Moderation Level</title>
                        <para>
                                To configure forum moderation level, click on the forum name in the forum list.
                                This allows you to select the moderation level between the following values:
                        </para>
                        <itemizedlist>
                            <listitem><para>No Moderation.</para></listitem>
                            <listitem><para>Moderated Level 1: To moderate anonymous posts (if allowed in public forum) and posts from non-member users.</para></listitem>
                            <listitem><para>Moderated Level 2: To moderate <emphasis>all</emphasis> posts (except admin posts).</para></listitem>
                        </itemizedlist>
                </section>
	</section>
	<section id="ug_project_forums_searching">
		<title>Searching</title>
		<para>
			When using a forum, a voice <guimenuitem>Forum</guimenuitem> will appear in the search combo box. Selecting <guimenuitem>Forum</guimenuitem> and inserting a text in the search box allows you to search through the text data of the forum.
		</para>
	</section>
</section>
