CONTRIBUTING.md

   1 # Torque 3D contribution guidelines
   2
   3 So you want to help Torque out by contributing to the repo? That's awesome!
   4 We just ask that you'd give this document a quick read to get yourself familiar with the process.
   5 Do you want to [request a feature](#request-a-feature)?
   6 Create a [pull-request](#create-a-pull-request) to contribute your own code to the engine?
   7 [Report an issue](#report-an-issue) you've discovered?
   8
   9 ## Report an issue
  10
  11 Before you report an issue with the engine, please [search](https://github.com/GarageGames/Torque3D/issues) and quickly make sure someone else hasn't obviously reported it.
  12 If you're not sure if it's the same issue, go ahead and comment on it!
  13 Once you're certain you've found a new issue, hit the [big green button](https://github.com/GarageGames/Torque3D/issues/new) and please include the following information:
  14
  15  * Your platform and compiler, if you're not using a precompiled binary
  16  * Steps to reproduce the issue, if _at all_ possible
  17  * If it's related to graphics, your GFX card and driver details.
  18
  19 ## Create a pull-request
  20
  21 We ask that potential contributors read our [pull-request guidelines](http://torque3d.org/contribute/#pull-request-guide) before opening a PR.
  22 We also have some [code style guidelines](https://github.com/GarageGames/Torque3D/wiki/Code-Style-Guidelines).
  23 Here's a quick guide to the branches in this repo that you might think of targeting a PR at:
  24
  25 ### The master branch
  26
  27 The repository's `master` branch is where we make releases.
  28 It's supposed to be stable at all times - or as stable as we can make it - and only gets updated when a new version comes out.
  29 Any pull-requests to the master branch will have to be rejected - sorry :(.
  30
  31 ### The development branch
  32
  33 The `development` branch is where most development happens.
  34 It is the target for the next 'middle' version of the engine (the 6 in 3.6.1, for example).
  35 This means we will add new features, and refactor code if it doesn't break existing games made with the engine _too_ much*.
  36 Most pull requests to `development` can be accepted if we like your code - unless they would potentially break users' games.
  37
  38 *How much is _too_ much is for the Steering Committee to decide.
  39
  40 ### The development-3.6 branch
  41
  42 The `development-3.6` branch is where we will make bugfixes and small patches to the previous stable 'middle' version.
  43 This branch is where the 'small' versions will be created - 3.6.2, 3.6.3, etcetera.
  44 So if you have a bugfix or tiny enhancement that doesn't require anyone to change their game, it'd be best appreciated in this branch.
  45
  46 ### TLDR
  47
  48 Don't make any PRs to `master`.
  49 PR new features and large fixes/refactorings to `development`.
  50 PR bugfixes to `development-3.6`.
  51
  52 ## Request a feature
  53
  54 We ask that all feature requests be discussed in the [GarageGames forums](http://www.garagegames.com/community/forums), our [IRC channel](http://torque3d.wikidot.com/community:chat), or on our [UserVoice feature request voting page](https://garagegames.uservoice.com/forums/178972-torque-3d-mit/filters/top) before making an issue here.
  55 If your idea is popular, we'll hear of it and probably make an issue ourselves, if we agree.
  56
  57 Even better - don't request a feature, start working on it!
  58 This engine isn't going to improve itself ;).