A .NET API Wrapper for Trello(http://trello.com)
To compile the project, you'll need Visual Studio 2010 or later.
To build the project, from the command line run:
Build-Solution.ps1 script will build the solution, run the facts (unit tests).
The Git Workflow
This is the Git workflow we're currently using:
When starting a new feature/unit of work.
Pull the latest. Begin by pulling to make sure you are up-to-date before creating a branch to do your work This assumes you have no local commits that haven't yet been pushed (i.e., that you were previously up-to-date with origin).
Create a topic branch to do your work. Working in a topic branch isolates your work and makes it easy to bring in updates from other developers without cluttering the history with merge commits. You should generally be working in topic branches. If you do make changes in the master branch, just run this command before commiting them, creating the branch just in time.
git checkout -b <topic branch>
Do your work. Follow this loop while making small changes and committing often.
- Make changes.
- Test your changes (you're practicing TDD, right?)
Add your changes to git's index.
git add -A
Commit your changes.
git commit -m "<description of work>"
if (moreWorkToDo) go to #3.1 else go to #4.
Integrate changes from other developers. Now you're finished with your feature or unit of work, and ready to push your changes, you need to integrate changes that other developers may have pushed chances since you started.
PRO TIP: CLOSE VISUAL STUDIO
There are a few steps to follow to make sure you keep the history clean as you integrate.
Fetch changes from origin. Use
git fetchinstead of
git pull, because
git pullautomatically tries to merge the new changes with your local commits, creating an ugly (and useless) merge commit.
git fetch origin
Rebase your topic branch against origin/master. You want to reolcated your changes on top of any changes that were pulled in the in the fetch, above. You need to do this against origin/master instead of master, because master isn't yet up to date (remember, you're still in your topic branch).
You might have rebase conflicts, in which case you'll need to resolve them before continuing with
git rebase --continue. You might want to use
git mergetoolto help.
git rebase origin/master
Test your changes with the new code integrated. This would be a good time to run your full suite of unit and integration tests.
git clean -xdf .\Build-Solution.ps1
The first command cleans any untracked files that could get in the way of a good commit.
Integrate your changes into the master branch. Now that your topic branch has a clean history, it's easy to use
git rebaseto integrate your changes into the master branch with the following three commands. Note that the
git pullwill not create a merge commit, provided you haven't made any changes on master (e.g., that you followed the advice of making all changes in your topic branch).
git checkout master git pull git rebase <topic branch>
Push changes. Now that you're master branch's history is correct and clean, you can push to origin.
git push origin
Delete the topic branch The topic branch you created in Step #2 is no longer needed so it's best to delete it and start with a new clean branch when you're ready to start your next unit of work.
git branch -d <topic branch>