Allura/docs/using.rst

..     Licensed to the Apache Software Foundation (ASF) under one
       or more contributor license agreements.  See the NOTICE file
       distributed with this work for additional information
       regarding copyright ownership.  The ASF licenses this file
       to you under the Apache License, Version 2.0 (the
       "License"); you may not use this file except in compliance
       with the License.  You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

       Unless required by applicable law or agreed to in writing,
       software distributed under the License is distributed on an
       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
       KIND, either express or implied.  See the License for the
       specific language governing permissions and limitations
       under the License.

We don't have much end-user help for Allura yet.  SourceForge projects use Allura,
though, so their support documentation may be useful to anyone using Allura:

Configuring your project
------------------------

See SourceForge help page: https://sourceforge.net/p/forge/documentation/Create%20a%20New%20Project/

Note there are some SourceForge-specific references that don't apply to other Allura instances.


Using tickets
-------------

See SourceForge help page: https://sourceforge.net/p/forge/documentation/Tickets/


Using the wiki
--------------

See SourceForge help page: https://sourceforge.net/p/forge/documentation/Wiki/


Using a discussion forum
------------------------

See SourceForge help page: https://sourceforge.net/p/forge/documentation/Discussion/


Adding an external link
-----------------------

See SourceForge help page: https://sourceforge.net/p/forge/documentation/External%20Link/


Using markdown syntax
---------------------

Everything in Allura uses Markdown formatting, with several customizations and macros
specifically for Allura.  There are "Formatting Help" buttons throughout Allura for
easy reference to the Markdown syntax.  One such page is https://forge-allura.apache.org/p/allura/wiki/markdown_syntax/