A tool for facilitating the redlining of documents by the GitHub uninitiated.
How it works
- You give the editor a unique, hashed URL
- They edit the GitHub-hosted document, either semi-anonymously or authenticated through Github
- When they click submit, Redliner automatically creates a pull request on their behalf
Are users authenticated?
By default, the user is simply prompted to enter their name, so be sure to only share URLs with those you trust.
The user can also authenticate with their GitHub account, if they have one, which will create the pull request on their behalf, rather than using a bot account.
How to generate a hashed URL
github.com for your hosted Redliner instance in the URL to any file on GitHub.
You will be automatically redirect to the unique, hashed URL which you can then share with other, non-GitHub users.
This app is a simple Sinatra app. It's designed to run on Heroku, but can run anywhere.
First, you'll need to create a developer application, which is used to authenticate users with GitHub accounts. The callback URL for authentication is simply the root URL. Once done, set these two environmental variables:
Next, you'll want to create a bot account with a personal access token scoped to the relevant repositories. Select
public_repo to give it permission to read and write from repositories that it can access (and/or
repo if it'll be working with private repos). Using your main account, make sure that the bot has both read and write access to each repository it will access. Once done, simply set the personal access token as:
You'll also need a Redis database. The free level of any of the Heroku addons should work, but Redistogo will work out of the box. Just run
heroku addons:add redistogo
If you want to use a different provider, just make sure that the database's URL is set as
Still in development. There's a lot to be done, and we'd love your help.
- Take a look at the open issues.
- Fork the repository
- Create a descriptively named feature branch
- Tackle an open issue
- Submit a pull request
Install your fork of Redliner locally:
git clone firstname.lastname@example.org:your-name/redliner.git cd redliner bundle install touch .env git checkout -b descriptive-branch-name
Set your local variables for
.env. You'll probably want to create a separate Github application for this, as you'll need to set
localhost:5000 as the callback URL.
Then, start up a local Redis server (you may need to install Redis):
redis-server --port 16379
Start the app: