Find Task, Complete, Upload, Submit

After you have created both accounts it’s time to find a task.

Find a task on Bugzilla that needs to be done.

  1. Click the browse option from your Bugzilla account.
  2. Select a project and a component to view all open tasks.
  3. Click a bug id of the task you pledge to complete to open a detailed view.
  4. Make sure that the “status” field is CONFIRMED.
  5. Change the “status” field to IN_PROGRESS.
  6. Change the “assigned to” field to be yourself. This will let everyone know that you are working on that task.
  7. Click save.
Note that you can use the advanced search feature on Bugzilla to have more control of your queries.
Complete the task.
  1. You will first need to clone the source code for the project.

    $git clone ssh://your_username@mobile.cs.fsu.edu:29418/project/path/ProjectName.git

  2. Pull the script to automatically create the “change-id” field in your commit messages.

    $cd ProjectName/
    $scp -p -P 29418 your_username@mobile.cs.fsu.edu:hooks/commit-msg .git/hooks/

  3. You can now import that project into Eclipse, make your changes, and manage your own local git repo.
Upload your Change Log (CL)
Once you feel you have completed the task in ONE CL you must upload it for review.
  1. Configure git to push your current branch to Gerrit’s code review branch. Note you only have to do this once per project clone.

    $git config remote.origin.push refs/heads/*:refs/for/*

  2. In your commit message copy and paste URL from Bugzilla of the task that you are completing. For example: http://mobile.cs.fsu.edu/bugzilla/show_bug.cgi?id=2  This let’s use easily view the bug from inside of Gerrit.
  3. Put your changes on Gerrit.

    $git push

    Note: Make sure you have the .gitignore file included in your project’s home directory. This will prevent all your generated files from being added.

  4. Add a reviewer to your code.
  5. Wait to hear back from the reviewer. You will be notified by email once the review has happened.
  6. Most likely your first few changes will get kicked back from some reason. Address all the comments from the reviewer and reupload. This time you will have to amend to your commit. DO NOT create another commit.

    $git commit ––amend
    $git push

Submit your Change Log

Once your CL have been approved with a +2 your code is ready to merged into our repo.

  1. Click the “Submit” button in Gerrit. This option will only appear after a reviewer has given you a +2.
  2. Copy the URL of the submission that Gerrit creates.
  3. Paste the URL in “Additional Comments” under that task’s detailed view in Bugzilla. This let’s everyone easily go directly to the change that fixed this bug.
  4. Also in the detailed view, change the status to RESOLVED. This marks the task as complete.
  5. Click save and do a dance. You have contributed to The Mobile Lab. Go tell your mother. Thanks.