= ASA Database Trac =

This Trac is primarily to help development of the ASA Database, which is used to track information about recognized student groups (and some other stuff...).

If you have a problem using the ASA Database, please email asa-exec. Please include the answers to [/browser/docs/reporting-problems.txt these questions] when emailing.

== Bug Tracker ==

The main thing the Trac is used for is the [/query bug tracker]. Related pages:

 * Please keep the SizeDescriptions in mind when creating tickets
 * PossibleNextTickets has tickets that, for various reasons, might be a good next place to work
 * Dump tickets grouped by:
   * TicketsByMilestone
   * TicketsByComponent
   * TicketsByImpactedParty

== Documentation ==

 ExternalData:: List of data that should be edited externally, rather than through the database
 ReportingInterface:: Information on how to use the reporting interface, including directions for using it to update the group lists for non-DB forms.
 RecognizingGroups:: How to recognize a group (normal and NGE) in the ASA DB, along with the forms that they need to fill out.

== Code ==

If you want to see the database code, you can view it [[browser:|here in Trac]], or clone it with git by running "`git clone https://asa-db.scripts.mit.edu/git/asa-db/asa-db.git`".

We also have [[browser:/docs/install-on-scripts.txt|instructions for installing a development version]] on the [[http://scripts.mit.edu/|Scripts web hosting platform]] (where the production database lives).

== Information about Trac ==

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.org/ Trac] to better fit your project, especially in
regard to ''components'', ''versions'' and ''milestones''. 


TracGuide is a good place to start.

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

=== Starting Points ===

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

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