A tool for facilitating the redlining of documents by the GitHub uninitiated.
- 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
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.
Swap 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:
GITHUB_CLIENT_IDGITHUB_CLIENT_SECRET
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:
GITHUB_TOKEN
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 REDIS_URL.
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 [email protected]:your-name/redliner.git
cd redliner
bundle install
touch .env
git checkout -b descriptive-branch-name
Set your local variables for GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, and GITHUB_TOKEN in .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:
foreman start
