How to Contribute - Vanilla Success
<main> <article class="userContent"> <div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/TUTPUUE97EVD/microsoftteams-image-288-29.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/TUTPUUE97EVD/microsoftteams-image-288-29.png" alt="MicrosoftTeams-image (8).png" height="108" width="1356" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="general">General</h2><ol><li>Welcome folks to the <a href="https://open.vanillaforums.com/" rel="nofollow noreferrer ugc">community</a> and be awesome!</li><li>Answer questions.</li><li>Report <a href="https://github.com/vanillaforums/vanilla" rel="nofollow noreferrer ugc">issues</a> like a pro (see below).</li><li><a href="https://docs.vanillaforums.com/developer/contributing/#triaging-issues" rel="nofollow noreferrer ugc">Triage</a> issues already reported!</li><li>Test <a href="https://open.vanillaforums.com/categories/blog" rel="nofollow noreferrer ugc">pre-releases</a>.</li><li>Contribute <a href="https://github.com/vanilla/docs" rel="nofollow noreferrer ugc">docs</a>.</li><li>Help <a href="https://docs.vanillaforums.com/developer/locales" rel="nofollow noreferrer ugc">translate Vanilla</a>.</li><li>Evaluate community addons & offer feedback.</li><li>Do accessibility testing! Unplug your mouse, turn on a screen reader, and see what it’s like to use Vanilla.</li></ol><h2 data-id="developers">Developers</h2><ol><li>Contribute code via <a href="https://docs.vanillaforums.com/developer/contributing/pull-requests" rel="nofollow noreferrer ugc">pull requests</a> (requires <a href="https://open.vanillaforums.com/contributors" rel="nofollow noreferrer ugc">Contributor Agreement</a>)</li><li>Contribute addons & themes to the <a href="https://open.vanillaforums.com/addons" rel="nofollow noreferrer ugc">Official Directory</a>.</li><li>Audit code for security & disclose issues <a href="https://docs.vanillaforums.com/developers" rel="nofollow noreferrer ugc">responsibly</a>.</li></ol><p>Sections of our contribution guidelines are adapted or copied from <a href="https://swift.org/contributing/" rel="nofollow noreferrer ugc">Swift</a> because they are awesome.</p><h2 data-id="reporting-issues-like-a-pro">Reporting issues like a pro</h2><p>First, check for duplicates by searching on GitHub. All clear? Then make sure you cover three points:</p><ul><li>A concise description of the problem. If the issue is a fatal error, include a debug trace. Otherwise, describe the behavior you were expecting to see, along with the behavior you actually observed.</li><li>A reproducible test case. If you need to include a lot of code to do this, make a gist on GitHub and link it.</li><li>Include the precise Vanilla version number and any relevant system information (ex: OS, PHP version & settings, MySQL settings).</li></ul><h2 data-id="triaging-issues">Triaging issues</h2><p>There are a number of things you can do to help triage issues in the issue tracker.</p><ul><li>Reproduce it! For a bug to be actionable, it needs to be reproducible. If you can’t reproduce the bug, try to figure out why. Get in touch with the submitter if you need more information.</li><li>Reduce bugs. Once a bug can be reproduced, reduce it to the smallest amount of code possible. Reasoning about a sample that reproduces a bug in just a few lines of Swift code is easier than reasoning about a longer sample.</li><li>Eliminate duplicates. If two bug reports refer to the same underlying problem, mark the newer one as a duplicate of the older one. Doing so allows others to work more effectively.</li></ul><p><br></p> </article> </main>