HowToContribute – The Trac Project

<!DOCTYPE html> <html lang="en-US"> <head>   <title> HowToContribute – The Trac Project </title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" />  <link rel="search" href="/search" /> <link rel="help" href="/wiki/TracGuide" /> <link rel="alternate" href="/wiki/HowToContribute?format=txt" title="Plain Text" type="text/x-trac-wiki" /> <link rel="start" href="/wiki" /> <link rel="stylesheet" href="/chrome/common/css/trac.css" type="text/css" /> <link rel="stylesheet" href="/chrome/common/css/wiki.css" type="text/css" /> <link rel="stylesheet" href="/chrome/wikiextras/css/phrases.css" type="text/css" /> <link rel="stylesheet" href="/chrome/wikiextras/css/boxes.css" type="text/css" /> <link rel="stylesheet" href="/wikiextras/dynamicboxes.css" type="text/css" /> <link rel="stylesheet" href="/chrome/vote/css/tracvote.css" type="text/css" /> <link rel="icon" href="/favicon.ico" type="image/x-icon" /> <noscript> <style> .trac-noscript { display: none !important } </style> </noscript> <link type="application/opensearchdescription+xml" rel="search" href="/search/opensearch" title="Search The Trac Project"/> <script src="/chrome/common/js/jquery.js"></script> <script src="/chrome/common/js/babel.js"></script> <script src="/chrome/common/js/trac.js"></script> <script src="/chrome/common/js/search.js"></script> <script src="/chrome/common/js/folding.js"></script> <script src="/chrome/common/js/wiki.js"></script> <script> jQuery(function($) { $(".trac-autofocus").focus(); $(".trac-target-new").attr("target", "_blank"); if ($.ui) { /* is jquery-ui added? */ $(".trac-datepicker:not([readonly])") .prop("autocomplete", "off").datepicker(); // Input current date when today is pressed. var _goToToday = $.datepicker._gotoToday; $.datepicker._gotoToday = function(id) { _goToToday.call(this, id); this._selectDate(id) }; $(".trac-datetimepicker:not([readonly])") .prop("autocomplete", "off").datetimepicker(); $("#main").addClass("trac-nodatetimehint"); } $(".trac-disable").disableSubmit(".trac-disable-determinant"); setTimeout(function() { $(".trac-scroll").scrollToTop() }, 1); $(".trac-disable-on-submit").disableOnSubmit(); }); </script>  <link rel="stylesheet" type="text/css" href="//www.edgewall.org/css/projects013.css" /> <script type="text/javascript"></script> <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/1.0.9/cookieconsent.min.js"></script> <script type="text/javascript"> jQuery(function($) { var $ntg = $("#newticketguide"); if ($ntg.length) $("#propertyform").prepend($ntg.detach()); }); </script>   <script> jQuery(function($) { wikiColumn($("#wikipage")); }); </script>  </head> <body>    <div id="wrapper"> <div id="topbar"> <a id="home-link" href="//www.edgewall.org/">Edgewall Software</a> </div> <div id="ew-header"> <div id="topnav"><ul> <li><a href="//www.edgewall.org/">Home</a></li> <li class="active"> <a class="trac" href="//trac.edgewall.org/">Trac</a> </li> <li> <a href="//trac-hacks.org/">Trac Hacks</a> </li> <li class=""> <a class="genshi" href="//genshi.edgewall.org/">Genshi</a> </li> <li class=""> <a class="babel" href="//babel.edgewall.org/">Babel</a> </li> <li class=""> <a class="bitten" href="//bitten.edgewall.org/">Bitten</a> </li></ul> </div> </div> <div id="ew-main"> <div id="ew-content"> <div> <script src="//www.google-analytics.com/urchin.js" type="text/javascript"></script> <script type="text/javascript">_uacct = "UA-598265-1";urchinTracker();</script> <div id="left"> <div class="block"> <ul> <li><a href="/">Home</a></li> <li><a href="/wiki/TracDownload">Download</a></li> <li><a href="/wiki/TracGuide">Documentation</a></li> <li><a href="/wiki/MailingList">Mailing Lists</a></li> <li><a href="/wiki/TracLicense">License</a></li> <li><a href="/wiki/TracFaq">FAQ</a></li> </ul> </div> </div> </div>  <div id="banner"> <div id="header"> <a id="logo" href="//trac.edgewall.org/"> <img alt="Trac" height="73" src="//www.edgewall.org/gfx/trac_logo.png" width="236" /></a> </div> <form id="search" action="/search" method="get"> <div> <label for="proj-search">Search:</label> <input type="text" id="proj-search" name="q" size="18" value="" /> <input type="submit" value="Search" /> </div> </form> <div id="metanav" class="nav"> <ul><li class="first"><a href="/login">Login</a></li><li ><a href="/prefs">Preferences</a></li><li ><a href="/wiki/TracGuide">Help/Guide</a></li><li class="last"><a href="/about">About Trac</a></li></ul> </div> </div> <div id="mainnav" class="nav"> <ul><li class="active first"><a href="/wiki">Wiki</a></li><li ><a href="/timeline">Timeline</a></li><li ><a href="/roadmap">Roadmap</a></li><li ><a href="/browser">Browse Source</a></li><li ><a href="/report">View Tickets</a></li><li ><a href="/wiki/NewTicket">New Ticket</a></li><li class="last"><a href="/search">Search</a></li></ul> </div> <div id="main" > <div id="pagepath" class="noprint"> <a class="pathentry first" title="View WikiStart" href="/wiki">wiki:</a><a href="/wiki/HowToContribute" title="View HowToContribute" class="pathentry">HowToContribute</a></div> <div id="ctxtnav" class="nav"> <h2>Context Navigation</h2> <ul> <li class="first"><span id="vote" title="Vote count"><img alt="Up-vote" src="/chrome/vote/aupgray.png" /><span id="votes">+0</span><img alt="Down-vote" src="/chrome/vote/adowngray.png" /></span></li> <li ><a href="/wiki/WikiStart">Start Page</a></li> <li ><a href="/wiki/TitleIndex">Index</a></li> <li class="last"><a href="/wiki/HowToContribute?action=history">History</a></li> </ul> <hr /> </div>  <div id="content" class="wiki narrow"> <div class="wikipage searchable"> <div id="wikipage" class="trac-content borderless"><h1 class="section" id="WeNeedYourHelp">We Need Your Help!</h1> <p> There are many ways in which you can become involved in the Trac project. Even if you are not a programmer, there are ways that you can benefit from Trac and ways to help make Trac more useful to yourself and others. </p> <p> You can find out what's going on in the community by joining the <a class="wiki" href="/wiki/MailingList">MailingList</a>, where Trac users and developers share information about the project and discuss freely and openly. </p> <p> If you are interested in "live" communication with the <a class="wiki" href="/wiki/TracTeam">TracTeam</a>, contributors and users, you might be interested in the <a class="wiki" href="/wiki/IrcChannel">IrcChannel</a>. </p> <h2 class="section" id="UserFeedback">User Feedback</h2> <p> To make Trac better, we need <a class="wiki" href="/wiki/MailingList#Trac-users">user</a> and <a class="wiki" href="/wiki/MailingList#Trac-dev">developer</a> feedback. Even if you're not a programmer, bug reports, <a class="wiki" href="/wiki/TracIdeas">ideas and suggestions</a> are more than welcome. </p> <p> For bug reports and feature requests, we recommend filing <a class="wiki" href="/wiki/NewTicket">a new ticket</a> in the issue database after <a class="wiki" href="/wiki/NewTicketGuidelines#IsntThereAlreadyaSimilarTicket">searching existing issues</a>. </p> <p> You can also assist the Trac team by helping to do <a class="wiki" href="/wiki/TracTicketTriage">ticket triaging</a>, most notably by finding duplicate issues and squashing invalid tickets. Code review of proposed changes and testing development branches is appreciated, but please use a <a class="wiki" href="/wiki/TracDev/DevelopmentEnvironmentSetup">development instance</a> rather than running the latest changes in production. </p> <h2 class="section" id="CodeContributions">Code Contributions</h2> <p> Naturally, contributions in source code form are more than welcome. </p> <p> See <a class="wiki" href="/wiki/TracDev">TracDev</a> for resources about Trac development, in particular <a class="wiki" href="/wiki/TracDev/SubmittingPatches">TracDev/SubmittingPatches</a> and <a class="wiki" href="/wiki/TracDev/CodingStyle">TracDev/CodingStyle</a> and check the <a class="wiki" href="/wiki/TracRepositories">TracRepositories</a> page for details concerning access to the code (via svn, or hg or git mirrors). </p> <p> The following tickets may be good starting points: </p> <ul><li><strong><a class="query" href="/query?status=new&status=assigned&status=reopened&keywords=~bitesized&group=component&order=priority">bitesized</a> tickets</strong> (small work items, ideal for new contributors to dive into the code) </li><li><a class="query" href="/query?status=new&status=assigned&status=reopened&keywords=~helpwanted&group=component&order=priority">helpwanted</a> tickets (tickets which are looking for contributors) </li><li><a class="query" href="/query?status=new&status=assigned&status=reopened&keywords=~review&order=priority">review</a> tickets (peer review requested) </li><li><a class="query" href="/query?status=new&status=assigned&status=reopened&keywords=~documentation&order=priority">documentation</a> tickets (things that need to be better documented) </li></ul><p> To see what are the hot issues, have a look at the <a class="wiki" href="/wiki/ToDo">ToDo</a> lists and don't forget to look at the <a href="/roadmap">Roadmap</a>. </p> <h2 class="section" id="DocumentationContributions">Documentation Contributions</h2> <p> The authoritative version of the <a class="wiki" href="/wiki/TracGuide">TracGuide</a> as distributed with the software is an integral part of this Trac's wiki. Like any other page, they can be edited, clarified and enhanced in any way you seem fit. The changes you make there will be reviewed and most likely integrated in the <a class="source" href="/browser/trunk/trac/wiki/default-pages">repository</a> to be part of the next "official" guide. </p> <p> If you think that a large rewrite of a page would be even more appropriate and you are willing to do this effort, consider starting first with a new page, named like TheTracGuidePage/Discussion, where you can draft the change and gather feedback from other contributors. </p> <h2 class="section" id="TranslationContributions">Translation Contributions</h2> <p> Trac is available in <em>your</em> language. Help find the right terms and contribute to the translation effort! </p> <p> The easiest way to contribute translations is to register to our <a class="ext-link" href="https://www.transifex.com/cboos/trac/" title=" in Transifex"><span class="icon"></span>Transifex project</a>. </p> <p> See details in <a class="wiki" href="/wiki/TracL10N">TracL10N</a> and <a class="wiki" href="/wiki/TracGuideTranslations">TracGuideTranslations</a>. </p> <h2 class="section" id="Extensions">Extensions</h2> <p> Trac is extensible in a variety of ways. For example, you can add <a class="wiki" href="/wiki/WikiMacros">WikiMacros</a>. The <a class="ext-link" href="https://trac-hacks.org/intertrac/" title="Trac-Hacks Community Site"><span class="icon"></span>Trac Hacks site</a> is a good place to share them. </p> <p> You can also extend Trac with custom plugins. See <a class="wiki" href="/wiki/TracDev/PluginDevelopment">TracDev/PluginDevelopment</a> for more information. Again, <a class="ext-link" href="https://trac-hacks.org/intertrac/" title="Trac-Hacks Community Site"><span class="icon"></span>Trac Hacks</a> is a good place for sharing your plugins. </p> <hr /> <p> See also: <a class="wiki" href="/wiki/TracProject">TracProject</a>, <a class="wiki" href="/wiki/MailingList">MailingList</a>, <a class="wiki" href="/wiki/IrcChannel">IrcChannel</a>, <a class="wiki" href="/wiki/TracTeam">TracTeam</a> </p> </div> <div class="trac-modifiedby"> <span> <a href="/wiki/HowToContribute?action=diff&version=26" title="Version 26 by Ryan J Ollos: Remove mentioned of 0.12.">Last modified</a> <a class="timeline" href="/timeline?from=2025-02-08T04%3A14%3A28%2B01%3A00&precision=second" title="See timeline at Feb 8, 2025, 4:14:28 AM">7 weeks ago</a> </span> <span class="trac-print"> Last modified on Feb 8, 2025, 4:14:28 AM </span> </div> </div> <div class="buttons"> <form method="get" action="/wiki/HowToContribute" id="modifypage"> <div> <input type="hidden" name="action" value="edit" /> </div> </form> </div> <div class="trac-help"> <strong>Note:</strong> See <a href="/wiki/TracWiki">TracWiki</a> for help on using the wiki. </div> </div>  <div id="altlinks"> <h3>Download in other formats:</h3> <ul> <li class="last first"> <a rel="nofollow" href="/wiki/HowToContribute?format=txt" class=""> Plain Text</a> </li> </ul> </div>   </div> <div id="footer"><hr/> <a id="tracpowered" href="https://trac.edgewall.org/" ><img src="/chrome/common/trac_logo_mini.png" height="30" width="107" alt="Trac Powered"/></a> <p class="left"> Powered by <a href="/about"><strong>Trac 1.4.3</strong></a> <br /> By <a href="http://www.edgewall.org/">Edgewall Software</a> . </p> <p class="right">Visit the Trac open source project at<br /><a href="//trac.edgewall.org/">https://trac.edgewall.org/</a></p> </div>   </div> </div> </div> <div id="ew-footer"> <p><a href="mailto:info@edgewall.com">info@edgewall.com</a></p> <p>Copyright © 2003-2024 Edgewall Software. All rights reserved.</p> </div> <div id="right"> <div id="ohloh-badge"> <a href="//www.openhub.net/p/trac"> <img src="//www.openhub.net/p/trac/widgets/project_thin_badge.gif" /> </a> </div> <script type="text/javascript"></script> <script type="text/javascript" src="//pagead2.googlesyndication.com/pagead/show_ads.js"> </script> </div>    </body> </html>

CINXE.COM

HowToContribute – The Trac Project