jugglebird / barkeep Goto Github PK

Barkeep is a fast, fun way to review code. Engineering organizations can use it to keep the bar high.

To see a video of Barkeep in action, visit getbarkeep.org.

Barkeep is standalone software that you host. Once it's set up, you can use it to track and code review any number of git repos available on the internet. It's designed to be easy to run on Ubuntu.

Since Barkeep is a web app with dependencies like MySQL, Redis, and others, the easiest way to get it running quickly is to run it inside a virtual machine using Vagrant:

$ cd barkeep
$ script/vagrant_quick_start.rb

You will need a few dependencies (like VirtualBox) before you can set up Barkeep inside of Vagrant, but this script will help you get them. It will take a few minutes and once it's done, Barkeep will be running inside of Vagrant. You can then browse to http://localhost:8080 to play with it.

You can shut it all down later using bundle exec vagrant halt.

Once you decide to use Barkeep for your team, you should deploy it to an Ubuntu web server. See the Deploying Barkeep wiki page for more information.

See the wiki for instructions on setting up Barkeep for development, deploying it to your own server and tracking git repos with it.

Read here for a comparison of Barkeep to other code review systems.

Barkeep was designed to be easy to hack on with Mac or Ubuntu, so feel free to dive in. You can open a ticket to suggest a new feature. If you fix a bug or implement a small feature, send us a pull request. If you want to implement a larger feature, please post a description of the feature on the mailing list beforehand so that we can be sure it's something we want to add.

Simple style guidelines: mimic the style around you, cap lines at 110 characters, and follow the usual conventions for commit messages.

Please file user issues as tickets here on Github.

The Barkeep developer mailing list is used for discussion around developing Barkeep. You can email the group at [email protected].

Barkeep was written by the following Ooyala engineers:

• Bo Chen (bo-chen)
• Phil Crosby (philc)
• Kevin Le (bkad)
• Daniel MacDougall (dmacdougall)
• Caleb Spare (cespare)

and with contributions from other Ooyala engineers:

• Noah Gibbs (noahgibbs)
• Brian Zhou (zdyn)
• Manish Khettry (mkhettry)

and community members:

• Alberto Leal (albertoleal)
• Alice Kærast (kaerast)
• Dann Luciano (dannluciano)
• Dylan Tack (dylantack)
• Liron Yahdav (lyahdav)
• Michael Quinn (mikejquinn)
• Ron Toland (mindbat)

Barkeep is released under the MIT license.