[[PageOutline(2-5,Content)]]

= Hack Procedures

The TracHacks page contains more information, contact details, bug reports, enhancements, suggestions, etc.

== How to Contribute

We have made things as simple as possible:

 1. [/register Register] a user name then [/login login] (requires cookies).
 1. Fill out the NewHack form.
 1. Verify all the details for your new page are correct.
 1. Commit your code to the provided Subversion URL. Alternatively you can simply attach your hack to your Wiki page, but you can't delete or replace attachments.
 1. Consider subscribing to the [wiki:WikiStart#FeedbackandSuggestions trac-hacks mailing list].

=== List Your Own Hack Hosted Elsewhere

Feel free to create a stub page here with a short description and links to your own hack. Please stick to the page naming convention, by appending the hack type, eg. '''Gantt Plugin'''. Therefore the !DoStuff macro should get a page named `DoStuffMacro`.

Once you have created your page, tag it with the hack type and it will appear on the HackIndex. Tag it with your TracHacks [wiki:user] ID, if you want it to show up on your user page.

=== Adopt Unmaintained Hacks

See AdoptingHacks.

== How to Use Tags

TracHacks uses TagsPlugin to add basic categorisation to its Trac content. 

=== Meta-tags

Additionally, TracHacks uses a couple of [wiki:metatag metatags] when creating new hacks; [wiki:release release] and [wiki:type type].

  '''''Please don't abuse this.'''''

If a tag page (eg. [wiki:macro macro]) is itself tagged with one of the meta-tags, it will be included as an option in NewHack. That's quite a confusing sentence, so just take a look at [wiki:type type] for an example.

== Site-specific TracLinks

We have defined some shortcuts for commonly used links, such as `google:search`, `trac:wikipage`, `trac-changeset:changeset` and `trac-ticket:ticket`. Use these TracLinks for your convenience, see InterMapTxt for a complete list.

Examples:
 * [wiki:user Registered users] of TracHacks
 * Hacks for Trac [wiki:0.11], [wiki:0.12] and [wiki:1.0]
 * [wiki:example Example] hacks

== Community and Site Evolution

Following proposals hold more ideas on best-practice and may even yield procedures and guidelines in the future:
[[ListTagged(proposal)]]

You're heartily invited to join in for discussion and even more suggestions.

----
See also: TracHacks, TracHacks/SiteMaintenance, AdoptingHacks