Contribution

From VDrift
Revision as of 02:35, 10 December 2010 by Thelusiv (talk) (marking for review)
Jump to: navigation, search

How you can help

We can always use help with:

  • Testing & bug reports
  • Feedback and feature ideas
  • Documentation
  • Packaging
  • Game data (cars & tracks)
  • Other game art (splash screens, menu graphics, sounds)
  • Promotion
  • Web site
  • User support
  • Coding new features

If you want to get started helping us out, the best way is to post on the forums, join our IRC channel and chat with the other developers, or just start developing! If you submit good patches, and we get to know you, we'll probably give you SVN commit access so you can do work on your own.

Reporting bugs, requesting features

Currently the VDrift project does not use a bug tracker (this may change). For now, you can post in our forums, under Bugs or Feature Requests.

Search!

Please search the forums before beginning a new topic, as some bugs may already have been already identified, and many features have been requested multiple times.

Bug reporting guidelines

Generally we will need to know the operating system, type of machine (32-bit or 64-bit is very important), amount of memory, type of video card (plus amount of video RAM), and version of the game you are running. Sometimes it may help to know which versions of SDL and other libraries VDrift uses are on your system (Linux/FreeBSD).

It also helps to know what options you're using in the game. If your problem is related to driving, please include in your report the input device you use and other control options. Likewise if you're having display issues it's helpful to know what display settings you're using. A good way to tell us about your configuration is to include in your report your VDrift.config file, or at least the sections of it relavent to the problem.

Tips

  • When you start your topic make sure to give it a meaningful title, like "Crash when changing display properties on Windows64".
  • If you can provide a "use-case" or series of steps that you took in the game that will help to reproduce the bug, this will greatly increase the chances that it will be fixed.

Submitting a patch

When posting a patch in the forums, please make sure you surround the content of your patch with the [code] and [/code] tags. This ensures it will be formatted properly. Also, be sure to preview your post before submitting it, and check it for errors. You may need to check in the "disable smileys" checkbox to make sure that some of your code is not changed into happy-faces.

Patches should be made with diff against the latest development version of VDrift. If you don't know how to make a patch, try googling.

Note: The Subversion command svn diff does not seem to provide a format that can be automatically applied to the source with the patch program. If your patch is very long, please use the actual diff utility, or request SVN commit access. Otherwise your patch will be delayed because we'll have to apply it by hand.