bitbucket 101

If you are new to hosting your code, DVCS code management, or either Git or Mercurial, this bitbucket 101 tutorial gives you a taste all of them. In this tutorial, you'll first install both Git and Mercurial for your operating system. You'll do some work using both Git and then Mercurial. Throughout, you'll use the hosted code management system that is bitbucket. The tutorial consists of the following pages:

• Set up Git and Mercurial
• Create an Account and a Git Repo
• Clone Your Git Repo and Add Source Files
• Fork a Repo, Compare Code, and Create a Pull Request
• Add Users, Set Permissions, and Review Account Plans
• Set up a Wiki and an Issue Tracker
• Set up SSH for Git
• Set up SSH for Mercurial
• Mac Users: SourceTree a Free Git and Mercurial GUI

The tutorial teaches you some simple DVCS workflows using basic Git and Mercurial commands.  You don't really need to know anything about Git or Mercurial to work through the tutorial. If you are a beginner, you may not be comfortable working this way. If you prefer to learn the tools before working through this tutorial, you can learn more about Git here. To learn more about Mercurial, you should start here.

How to work through the tutorial

If you are totally new to DVCS and/or bitbucket, you should work through each page sequentially as each new page builds on the material from the previous pages  At the end of each page is a Next heading that tells you where to go next.  If you get lost, you can use the navigation bar (to your left) to locate the next page.  If you feel confident skipping pages or just going to pages you need, feel free to do that too.

If you are a total beginner, you should allow at least a couple of hours to work through the entire tutorial. If you are experienced or just skimming pages, much of this will be familiar to you and it should not take too long.

→ Start the tutorial with Set up Git and Mercurial.

Skip the getting started stuff

You can skip the getting started bit if you want. Other things you might be interested in:

• frequently asked questions and answers
• the bitbucket Google group
• how to use your repository
• the bitbucket blog