Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 1.87 KB

CONTRIBUTING.md

File metadata and controls

35 lines (26 loc) · 1.87 KB
Raw

The quick version

  1. Open ReactiveUI.sln in VS2012 / VS2013
  2. Run tests, build ReactiveUI.sln in VS2012 on Win8
  3. Submit PR

How to start hacking on ReactiveUI (the more verbose version)

  1. Fork and Clone the source
  2. Create a new branch for your feature / bugfix
  3. Open the ReactiveUI.sln solution - this is the one you should use unless you're hacking on platform-specific code.
  4. Run all the tests, make sure they pass.
  5. Write some new tests that fail
  6. Make your change
  7. See those same tests pass! Hurrah!
  8. Push that branch to GitHub (git push -u origin my-cool-new-feature)
  9. Go to your fork on GitHub, you should see a button with your branch next to it labeled 'Pull Request'
  10. Type up some information about your change

To make a new NuGet release for private use

This looks hard, but once you get your environment set up, it's really only 'Build in VS, build in Mono, run script'

  1. Put the source into DropBox or another way you can share the same folder between a Mac and a PC (Parallels Shared Folders works too)
  2. Edit /CommonAssemblyInfo.cs and bump the version
  3. Open ReactiveUI.sln and build it in Release mode under VS2012 on Windows 8 / Win8.1 with the WP8 SDK installed (nothing earlier is supported)
  4. Open MonoDevelop, and build ReactiveUI_XSAll.sln in Release mode
  5. Back on the PC, run MakeRelease.ps1 and specify a NuGet SemVer, like MakeRelease.ps1 -version "5.5.0-beta1"
  6. You'll end up with two new folders, Release and Nuget-Release, as well as the .nupkg files in the root directory.

Some quirks

  • The only 100% guaranteed .sln files to be maintained are ReactiveUI.sln and ReactiveUI_XSAll.sln - the others may be missing projects
  • Please follow my coding convention when submitting PRs - if statements have the brackets on the same line, non-public methods shouldBeCasedLikeThis, etc etc. I know I'm weird, Deal With It(tm).