= Welcome to the Oni Community Bug Tracker =

This is where we report bugs and desired features in the software that the community has produced and stored on our [http://websvn.chrilly.net/listing.php?repname=Oni2 Subversion repository], as well as the core mod packages for the [http://wiki.oni2.net/AE Anniversary Edition] on the [http://mods.oni2.net Mod Depot]. This site runs on [http://trac.edgewall.org/ Trac], which provides a '''wiki''', '''timeline''', '''ticket system''', and roadmap (not used here). Full documentation is found under the "Help/Guide" link at the top-right, but here's some starter tips and links.

If you're not familiar with the Trac '''wiki''', you'll have a small amount of adjusting to do, as it's a bit closer to the original wiki software, [wikipedia:WikiWikiWeb]. Overall, though, the markup is pretty similar to MediaWiki, on which Wikipedia runs. Read WikiFormatting to learn the markup; I suggest especially paying attention to the CamelCase and WikiPageNames pages, as this aspect is quite different from MediaWiki. To disable wiki markup in various contexts, pre-pend a '!' to it. Click "Edit this page" to see how I use the '!' in the sentence after this one, for example. Raw HTML can be used by typing !{{{#!html htmlStuffHere}}}.

The '''Timeline''' shows the recent commits to Subversion, recent ticket changes, and edits to the wiki. It's an easy way to keep your finger on the pulse of the community's projects. If you are an RSS kind of person, look for the RSS icon at the bottom of the Timeline page for a feed link.

Filing '''tickets''' is pretty straight-forward, but one little tip: when you want to attach a file, and you check that little box called "I have files to attach to this ticket"... nothing will happen. Not right then. You have to hit "Create ticket", and ''then'' you will get a chance to attach the file. Now, what this means is that if you wanted to embed an image in your ticket, you have to name the image in your ticket before it even exists on the site. For instance, you would type "Here's the problem I'm having: ![[Image(Screenshot.jpg)]].", check the "I have files" box, hit Create, then upload Screenshot.jpg, and the image should now appear embedded in your ticket. Of course, you could always just go back and modify your ticket to add the image link after uploading the image, but the first way cuts down on edit noise in Trac's history.

Finally, read TracBatchModify to learn how to modify more than one ticket at a time.

There's a great gestalt effect from having the ticket system tied to the wiki tied to Subversion, which is that we can type things like "When are we taking care of ticket:1?" and "I see what you did there in r1" and you get automatic links with hovertext descriptions! Read TracLinks to see all the ways you can interlink the systems.


Support links for the Trac software can be found at TracSupport.