README.md

   1 TortoiseGit - The coolest Interface to Git Version Control\r
   2 ==========================================================\r
   3 \r
   4 TortoiseGit is a Windows Shell Interface to Git and based on TortoiseSVN. It's open source and can fully be build with freely available software.\r
   5 \r
   6 TortoiseGit supports you by regular tasks, such as committing, showing logs, diffing two versions, creating branches and tags, creating patches and so on (see our [Screenshots](https://code.google.com/p/tortoisegit/wiki/Screenshots) or [documentation](https://tortoisegit.org/docs/tortoisegit/)).\r
   7 \r
   8 * Website: [tortoisegit.org](https://tortoisegit.org)\r
   9 * Download: [tortoisegit.org/download](https://tortoisegit.org/download)\r
  10 * Manual: [tortoisegit.org/docs/tortoisegit/](https://tortoisegit.org/docs/tortoisegit/)\r
  11 * Issue tracker: [tortoisegit.org/issues](https://tortoisegit.org/issues)\r
  12 * Mailing lists: [tortoisegit-announce](https://groups.google.com/group/tortoisegit-announce),\r
  13                  [tortoisegit-users](https://groups.google.com/group/tortoisegit-users) and\r
  14                  [tortoisegit-dev](https://groups.google.com/group/tortoisegit-dev)\r
  15 * StackOverflow tag: [tortoisegit](http://stackoverflow.com/questions/tagged/tortoisegit)\r
  16 \r
  17 Download\r
  18 --------\r
  19 \r
  20 The latest release and language packs are available on the [download page](https://tortoisegit.org/download). There you also find the system requirements and latest release notes.\r
  21 \r
  22 The TortoiseGit team also provides [preview releases](https://download.tortoisegit.org/tgit/previews/) on an irregular basis. These versions are used by the TortoiseGit developers and are built from the latest code that represents \r
  23 the cutting edge of the TortoiseGit development.\r
  24 \r
  25 What to do if things go wrong or a crash happened?\r
  26 --------------------------------------------------\r
  27 \r
  28 Before reporting an issue, please search whether a similar issue already exists and check that your problem isn't fixed in our latest [preview release](https://download.tortoisegit.org/tgit/previews/).\r
  29 \r
  30 An important aspect of reporting issues it to have a reproducible way for the issue and also to mention your exact version of your operating system, the version of Git and the version of TortoiseGit (this information can be found on the TortoiseGit about dialog).\r
  31 \r
  32 TortoiseGit includes a crash reporter (if not disabled on installation), which automatically uploads crash dumps to drdump.com, where the TortoiseGit team can review them. If you have a reproducible way, please also file an issue and link the crash report.\r
  33 \r
  34 We have a special page describing [steps for debugging](src/Debug-Hints.txt), where the majority of ways does not require to build TortoiseGit on your own.\r
  35 \r
  36 How Can I Contribute?\r
  37 =====================\r
  38 \r
  39 You're welcome to contribute to this project! There are several aspects you can help on:\r
  40 \r
  41 * improving our [documentation](https://tortoisegit.org/docs/tortoisegit/) (see [doc/readme.txt](doc/readme.txt) file and [doc](doc) folder),\r
  42 * [translations](Languages/README.txt),\r
  43 * testing [preview releases](https://download.tortoisegit.org/tgit/previews/),\r
  44 * helping other users on the mailing lists,\r
  45 * improving our UIs, or also\r
  46 * coding (e.g., fix open issues or implement new features; see below for more information).\r
  47 \r
  48 Any help is appreciated!\r
  49 \r
  50 Feel free to report issues and open merge requests.\r
  51 \r
  52 Please also check the [contribution guidelines](doc/HowToContribute.txt) to understand our\r
  53 workflow.\r
  54 \r
  55 How to build\r
  56 ------------\r
  57 \r
  58 Building TortoiseGit normally is not necessary, however, it is easy. All necessary requirements and steps are described in the [build.txt](build.txt) file. Helpful might also be our short description in the [architecture.txt](architecture.txt) file.\r
  59 \r
  60 License\r
  61 =======\r
  62 \r
  63 TortoiseGit is licensed under the [GPLv2](src/gpl.txt).\r
  64 \r