Pivotal tracker logo

First, let's define some terminologies that might be hard for beginners.

Github is a web-based application that is used to store projects online and to encourage online collaboration.

Pivotal Tracker is a web-based project management application. It allows team collaboration on a single or multiple projects

Git is version control to help you interact with your project during collaboration like in Github. So you will use git to interact with different parts of your project in say, Github.

Git is a command line, like the Linux environment for Windows users.

To Start

Create your project management activities in the pivotal tracker. Give it a name, say you want to make a car repair project for clients. Let's call our project Car Repair'

Add User Stories, these are the specific details that you want to do in the project,e.g. Create advert page, to be our first story. The story type can be a feature(what users need to be implemented), chore(what the system needs and not important to the user), bug(an error), release(product to be delivered).

Every story will be unstarted by default until you start working on it. Add labels and tasks to be implemented in the system.

Now Integrate with Github

1. Create a repo in GitHub, call it car-repairs.
2. On pivotal tracker, navigate to more menu button
3. Select integration and choose a Github repository (car-repairs). You can write a short description and a title.

And that’s it, your project is now communicating.

The Project Part Now

Clone your repository to your local computer.

On windows, right click on the location you want to create the project and open git bash here(Git bash must be installed)

On Linux/Mac, open terminal and open project directory

i.e. git clone <github-repository-url> then open the project folder cd car-repairs

Open the project in your editor and create the project.

Project communicate through git

I always say that git is like a waiter serving you at the restaurant. You just sent to do specific things. If you sent for a wrong order, then the wrong order will be brought. This applies to git too.

On the terminal/gitbash, send your project to Github and will automatically be sent to the pivotal tracker. Do this

git add file_name

git commit -m "[ft-#user_id]commit message” User_story_id is from the pivotal tracker. This is the unique identifier of the user id.

git push origin branch_name Your project will be made public and user id will move from icebox to backlog in the pivotal tracker. This shows the is communication.

Github and pivotal tracker automatically does activity documentation for you using the commit message you make

For naming conventions between git commands and pivotal tracker read through this document.