Merge branch 'master' of github.com:michael/github

Author: michael

README.md

@@ -3,31 +3,49 @@ Github.js
 
 Ever wanted to store a file on Github right from the browser? Here you are.
 
+
+Expose API for a given repository.
+
 ```js
 var github = new Github({
   username: "YOU_USER",
   password: "YOUR_PASSWORD",
   auth: "basic"
 });
 
-// Expose API for a given repository
-
 var repo = github.getRepo(reponame);
+```
+
+Retrieve all available branches (aka heads) of a repository.
 
-// Store contents at a certain path (assumes UTF-8)
-// Files that don't yet exist are created on the fly.
+```js
+repo.listBranches, function(err, branches) {
+  
+});
+```
 
-repo.write('path/to/file', 'YOUR_NEW_CONTENTS', 'YOUR_COMMIT_MESSAGE', function(err) {
+Store contents at a certain path, where files that don't yet exist are created on the fly.
+
+```js
+repo.write('master', 'path/to/file', 'YOUR_NEW_CONTENTS', 'YOUR_COMMIT_MESSAGE', function(err) {
+  
+});
+```
+
+Not only can you can write files, you can of course read them.
+
+```js
+repo.read('master', 'path/to/file', function(err, data) {
 
 });
 ```
 
-Not only can you can write files, you can of course read them:
+Listing all files of a repository is easy too.
 
 ```js
 // Retrieve contents of a certain file (assumes UTF-8)
 
-repo.read('path/to/file', function(err, data) {
+repo.list('master', 'path/to/file', function(err, data) {
 
 });
 ```