Thank you for your interest in contributing to improve Rubberduck!
Below should be everything you need to know to get started with contributing to this project.
Get started with GitHub first, star
Don't know any C#? No problem, there is still plenty you can do to help!
This project uses the GitHub issue tracker to document ideas and suggest enhancements, as well as bugs. Because this creates lots of issues, we take the time to carefully label each one, to facilitate searching and browsing.
👍upvote existing issues and ideas you'd wish were fixed or implemented. 💬share your feedback and ideas, even (especially!) if it's "just a small thing". ✔️submitting a bug? Please provide and test clear steps to reproduce the problem, upload screenshots and/or include the logged exception stack trace(s), as applicable: the quicker we can track down a bug, the quicker we can fix it! ❌some excellent ideas are out-of-scope for this project; don't fret a rejected idea for an enhancement that is deemed too large or too complex to maintain. It's not you, it's us! ❌when posting a CLR/JIT stack trace, please avoid cluttering the issue with the "loaded assemblies" part; that (very) long list of loaded DLLs is not relevant.
The wiki is open for editing, and contributions are welcome.
✏️edit existing content to fix typos, update screenshots. 📄add new pages to document the source code and internal API.
The source code contains XML documentation that is compiled as an asset and that is ultimately used to generate content (English only) that is rendered on the website and sometimes accessible as an online resource from within Rubberduck.
Each page on the website generated from XML documentation in the source code, includes a link to 'edit this page' that points to the corresponding C# source file. With a GitHub login, it is easy to contribute enhancements to the documentation and content presented on the project's website.
You will find the XML documentation in the following folders/namespaces:
Just Saying Thanks
Maintaining open-source software is often a thankless, selfless activity that involves a small and volunteering contributor force. If you
Tell us how you found out about Rubberduck, share that story about an obscure bug you'd been chasing for years that a Rubberduck inspection just single-handedly pointed out in a minute.
We don't do any telemetry, so we don't know how our users are using Rubberduck. Tell us what your favorite features are, what features you're perhaps not using but wish you'd be able to find more information about.
So you want to get your hands dirty and fix that obnoxious bug in the last release? Well that's great, we like seeing new faces in the fray
Rubberduck is intimidatingly large project, even for long-time contributors. When an issue is deemed fairly simple to fix or implement, we label it with , ...or with increasing but always very subjective difficulty/complexity levels up to if you dare.
Level 3 and above demand a deeper knowledge of the inner workings of VBA (or VB6), the VBIDE, and Rubberduck's internal APIs - and we're always happy to help a contributor gain that knowledge!
Once you have a local copy of the repository, use Git commands (or GitHub tooling in Visual Studio) to commit your local changes, then push your local branch to your GitHub fork, and from there you can use GitHub to create your PR.
When you start work on an existing issue, comment on that issue to let us know you're on it and a pull request will be incoming as a result: don't hesitate to ask any questions you need answered to keep progressing, "issue" pages exist for that type of discussion!
Translations & Resources
Rubberduck doesn't speak your language? Get ResX Manager (available both as a Visual Studio plug-in and as a standalone application) and have it create all the necessary resource keys and help you navigate and track the many .resx files in the solution.
⚠️If you contribute a translation for a brand new previously unsupported language, please keep in touch with the dev team so that new resource keys can be translated when a new release is coming up; abandoned languages/translations will end up getting dropped.
Pull requests that improve wordings and translations are always welcome, too!