Create a repository (and add a reviewer)

You just arrived at the Bitbucket space station and it's time to go through the orientation process, part of which involves making updates to your welcome package and getting them approved. To get you started, we'll walk you through creating a repository with some content and giving someone access.

Step 1. Create a workspace and add a colleague

Start by creating a workspace for your repository and colleague. No need to have a colleague for this tutorial. For our purposes, you'll make a new friend that goes by the username breezycloud.

  1. Click + in the global sidebar and select Workspace under Create.

  2. Enter a Workspace name you'd like to use. If you pick a workspace name that already exists, you may need to edit the Workspace ID because all IDs must be unique.

  3. Click Create.

  4. You'll land on your workspace Repositories page. From there, click Settings.

  5. Click User groups under Access management. You'll see that you have only two groups and you're the only member of both groups.

  6. Click the Developers group. From there, you'll see a place to add new members.

  7. Search for breezycloud in the Username or email address field, pick that user, and click Add.

Now when you create a pull request for your future repository, you'll have someone to review it!

Step 2. Create a repository with some content

No worries about putting a whole bunch of code together for this repository. We'll provide you with some to start.

  1. Click + in the global sidebar and select Repository under Create.

  2. Make sure the team you created is the repository Owner.

  3. Enter anything you want for the Project name and Repository name. If you can't think of anything, how about Welcome package and First impressions, respectively.

  4. From Include a README?, select either of the Yes options.

  5. From Version control system, pick an option for the type of repository you want to create. If you're not sure, keep as is.

  6. Click Create repository and you'll land on the Source view of your brand, new repository.

  7. From Source, select  > Add file.

  8. Name the file survey.html, then copy this code and paste it into the main text area.

    Copy and paste these contents

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <style media="screen" type="text/css"> body { margin: auto; width: 700px; color: #FFFFFF; font-family: Arial, sans-serif; background-color: #172B4D; } body>h1 { margin: 50px; font-size: 50px; text-align: center; color: #0052CC; } </style> </head> <body> <h1>Working in a workspace in space</h1> <p> Welcome to the workspace! You've made it this far so we know that you've got the potential to do great things. Because you're going to be collaborating with other awesome people, anything you add needs to be code reviewed and approved. That's just how a workspace works! You should have already created a branch and checked it out locally. If you haven't, go back to the tutorial and do that now. We'll be here. </p> <p> Because you're on your own branch, you can go crazy. Spice up this file any way you like. Add more files to this repository if you see fit. If want to take it slow and are just here to learn about pull requests, you can use this opportunity to fill out our short questionnaire. </p> <br> <p> <b>Question 1</b>: Have you used pull requests before? </p> <p> <b>Answer 1</b>: **** Your answer here **** </p> <p> <b>Question 2</b>: Why do you want to learn about code review? </p> <p> <b>Answer 2</b>: **** Your answer here **** </p> <p> <b>Question 3</b>: Who do you plan to work with on Bitbucket? </p> <p> <b>Answer 3</b>: **** Your answer here **** </p> </body> </html>
  9. Click Commit and then Commit again from the dialog.

Your repository is looking pretty good now. Take a look around if you feel like it. If you click Settings and go to the User and groups access page, you'll see that your breezycloud colleague you added has repository access through the Developers group.


Additional Help