= The Trac User and Administration Guide =
[[TracGuideToc]]

= Welcome to Trac 0.9.2 =

Trac is a '''minimalistic''' approach to '''web-based''' management of
'''software projects'''. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress.

All aspects of Trac have been designed with the single goal to 
'''help developers write great software''' while '''staying out of the way'''
and imposing as little as possible on a team's established process and
culture.

As all Wiki pages, this page is editable, this means that you can
modify the contents of this page simply by using your
web-browser. Simply click on the "Edit this page" link at the bottom
of the page. WikiFormatting will give you a detailed description of
available Wiki formatting commands.

"[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created
a new Trac environment, containing a default set of wiki pages and some sample
data. This newly created environment also contains 
[wiki:TracGuide documentation] to help you get started with your project.

You can use [wiki:TracAdmin trac-admin] to configure
[http://trac.edgewall.com/ Trac] to better fit your project, especially in
regard to ''components'', ''versions'' and ''milestones''. 



Enjoy! [[BR]]
''The Trac Team''

== Starting Points ==

 * TracGuide --  Built-in Documentation
 * [http://projects.edgewall.com/trac/ The Trac project] -- Trac Open Source Project
 * [http://projects.edgewall.com/trac/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
 * TracSupport --  Trac Support

For a complete list of local wiki pages, see TitleIndex.

Trac is brought to you by [http://www.edgewall.com/ Edgewall Software],
providing professional Linux and software development services to clients
worldwide. Visit http://www.edgewall.com/ for more information.


The TracGuide is meant to serve as a starting point for all documentation regarding Trac usage and development. The guide is a free document, a collaborative effort, and a part of the [http://projects.edgewall.com/trac/ Trac Project] itself.

== Table of Contents ==
Currently available documentation:
 * TracGuide (This page)  -- Documentation starting point.
   * TracInstall -- How to install and run Trac.
   * TracUpgrade -- How to upgrade existing installations.
   * TracAdmin -- Administrating a Trac project.
   * TracImport -- Importing tickets from other bug databases.
   * TracIni -- Trac configuration file reference. 
   * TracPermissions -- Access control and permissions.
   * TracInterfaceCustomization -- Customizing the Trac interface.
   * TracPlugins -- Installing and managing Trac extensions.
   * TracWiki -- How to use the built-in Wiki.
   * TracBrowser -- Browsing source code with Trac.
   * TracChangeset -- Viewing changes to source code.
   * TracTickets -- Using the issue tracker.
   * TracReports -- Writing and using reports.
   * TracQuery -- Executing custom ticket queries.
   * TracRoadmap -- The roadmap helps tracking project progress.
   * TracTimeline -- The timeline provides a historic perspective on a project.
   * TracLogging -- The Trac logging facility.
   * TracRss -- RSS content syndication in Trac.
   * TracNotification -- Email notification.

 * [http://projects.edgewall.com/trac/wiki/TracFaq Trac FAQ] - A collection of Frequently Asked Questions (on the project website)

== Support and Other Sources of Information ==
If you are looking for a good place to ask a question about Trac, look no further than the [http://projects.edgewall.com/trac/wiki/MailingList MailingList]. It provides a friendly environment to discuss openly among Trac users and developers.

See also the TracSupport page for more information resources.