Contribute to Vixen

How to contribute to the Vixen application.

Overview

Vixen is an open source project and we love getting patches and contributions to make Vixen and its docs even better.

The Vixen application code is hosted on Github. You can clone the repository to get a copy of the source code to work with.

Development Libraries

There are a few libraries and tools that you need to have installed in order to get the application to build. Depending on how much you develop in other projects you may have these already installed.

  • Windows 10 or higher.
  • Visual Studio 2022
  • Git
  • Microsoft .NET Framework 4.8
  • Microsoft Visual C++ 2019 x86 Redistributable
  • Microsoft Visual C++ 2019 x64 Redistributable

The current build target is .NET 4.8 and Visual C++ 2019, but we are actively migrating to .NET 6 and will be using Visual C++ 2022.

See this article on Visual Studio settings you should use.

See this article for information on Git.

Workflow

When contributing to Vixen, we like to track all issues and improvements in our JIRA bug tracker. Work should have an associated issue created for it. It is a good idea to have an account in JIRA so you can work with the issues. See Lifecycle of an issue for guidance on how we manage issues.

You should strive to name your branches with the ticket number. i.e. VIX-2345. Any commits to the branch should start with the ticket number as well and then follow Git guidlines for commit messages. All submissions are done through pull requests on Github. See Branching Practices for guidance on this topic.

More information on how we manage JIRA can be found here.

Creating Issues

Alternatively, if there’s something you’d like to see in Vixen (or if you’ve found something that isn’t working the way you’d expect), but you’re not sure how to fix it yourself, please create an Issue in our JIRA board for anything in the application.


Last modified February 10, 2023: Refactor the Developer sections (c86a3d0)