add docs
This commit is contained in:
parent
c5c2378bad
commit
0a59885d39
77
README.md
77
README.md
|
@ -1,6 +1,77 @@
|
|||
#GitHub Burndown Chart
|
||||
##Rework in Progress
|
||||
|
||||
Displays a burndown chart from a set of GitHub issues in the current milestone.
|
||||
Displays a burndown chart from a set of GitHub issues in the current milestone; all client side.
|
||||
|
||||
[ ![Codeship Status for radekstepan/github-burndown-chart](https://www.codeship.io/projects/d69f4420-e5b0-0130-bbae-1632ddfb80f8/status?branch=rework)](https://www.codeship.io/projects/5855)
|
||||
[ ![Codeship Status for radekstepan/github-burndown-chart](https://www.codeship.io/projects/d69f4420-e5b0-0130-bbae-1632ddfb80f8/status?branch=rework)](https://www.codeship.io/projects/5855)
|
||||
|
||||
![image](https://raw.github.com/radekstepan/github-burndown-chart/master/example.png)
|
||||
|
||||
##Quickstart
|
||||
|
||||
1. Choose a repo that you want to display burndown chart for.
|
||||
1. Make sure this repo has some issues assigned to a milestone.
|
||||
1. Put some labels on the issues looking like this: `size 1`, `size 3` etc.
|
||||
1. Close some of them labeled issues.
|
||||
1. Visit [http://radekstepan.github.io/github-burndown-chart](http://radekstepan.github.io/github-burndown-chart) following the instructions there.
|
||||
|
||||
##Configuration
|
||||
|
||||
There are three modes of operation balancing between usability & security:
|
||||
|
||||
1. You can just serve the `public` directory using a static file server or GitHub Pages. No config needed, just serve the app and point to your repo in the browser, e.g.: `http://127.0.0.1:8000/#!/radekstepan/disposable`. You are rate limited to the tune of [60 requests per hour](http://developer.github.com/v3/#rate-limiting).
|
||||
1. As before but now you want to use your [GitHub OAuth2 API Token](http://developer.github.com/v3/#authentication) in the config. This will require you to specify the token in the `config.json` file as outlined below.
|
||||
1. You find it preposterous to share your token with the world. In this case you will need to serve the app through `proxy.coffee`. Your token will be scrubbed from the config file and all requests be routed through this proxy.
|
||||
|
||||
None of the following fields or the file, `config.json` itself are required:
|
||||
|
||||
###Size Label
|
||||
|
||||
The way we are getting a size of an issue from GitHub is by putting a label on it. The following regex (string) specifies which part of the label represents the number.
|
||||
|
||||
```json
|
||||
{
|
||||
"size_label": "^size (\\d+)$"
|
||||
}
|
||||
```
|
||||
|
||||
This is also the default label if no other is specified.
|
||||
|
||||
###Token
|
||||
|
||||
Your OAuth2 token from GitHub. Get it [here](https://github.com/settings/applications). Bear in mind that if you just statically serve the app, everybody will be able to see the token in transmission. If you would like to avoid that, use the `proxy.coffee` file to route the traffic.
|
||||
|
||||
Using the token increases your limit of requests per hour from [60 to 5000](http://developer.github.com/v3/#rate-limiting).
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "API_TOKEN"
|
||||
}
|
||||
```
|
||||
|
||||
###Off Days/Weekends
|
||||
|
||||
An array of day integers (Monday = 1) representing days of the week when you are not working. This will make the expected burndown line be more accurate.
|
||||
|
||||
```json
|
||||
{
|
||||
"off_days": [ 6, 7 ]
|
||||
}
|
||||
```
|
||||
|
||||
##Proxy Mode
|
||||
|
||||
Use this strategy if you do not wish for your token to be publicly visible. Proxy mode routes all requests from the client side app through it, scrubbing the token from the `config.json` file. It is *slightly* slower than requesting data straight from GitHub of course.
|
||||
|
||||
Make sure you have [CoffeeScript](http://coffeescript.org/) installed:
|
||||
|
||||
```bash
|
||||
$ npm install coffeescript -g
|
||||
```
|
||||
|
||||
Then start the proxy passing port number as an argument:
|
||||
|
||||
```bash
|
||||
$ PORT=1234 coffee proxy.coffee
|
||||
```
|
||||
|
||||
Visit the port in question in the browser and continue as before.
|
|
@ -8,7 +8,7 @@ request = require 'request'
|
|||
# Read the original config.
|
||||
config = JSON.parse fs.readFileSync './config.json', 'utf-8'
|
||||
# This is the scrubbed version.
|
||||
_.extend scrubbed = {}, config, { protocol: 'http', token: null }
|
||||
_.extend scrubbed = {}, config, { 'protocol': 'http', 'token': null }
|
||||
|
||||
proxy = (req, res, next) ->
|
||||
write = (code, body) ->
|
||||
|
|
Loading…
Reference in New Issue