Permalink
Browse files

Merge pull request #2 from rudyrigot/master

Making the Rails starter kit work out of the box
  • Loading branch information...
2 parents 139ea02 + da1eac9 commit 8c1ea8ad51dcecf0a971696b034d0c22b6e842f9 @guillaumebort guillaumebort committed Nov 15, 2013
Showing with 14 additions and 1 deletion.
  1. +0 −1 .gitignore
  2. +14 −0 README.md
  3. 0 config/{prismic.yml.sample → prismic.yml}
View
@@ -14,4 +14,3 @@
# Ignore all logfiles and tempfiles.
/log/*.log
/tmp
-config/prismic.yml
View
@@ -4,6 +4,20 @@ This is a blank Rails project that will connect to any [prismic.io](https://pris
repository. It uses the prismic.io Ruby developement kit, and provides few helpers
to use it with Rails.
+### How to start?
+
+If you haven't yet, install the latest versions of [Ruby](https://www.ruby-lang.org/en/downloads/), [Rails](http://rubyonrails.org/download) and [RubyGems](http://rubygems.org/pages/download).
+
+After forking and cloning the starter kit, it is immediately operational, so you can launch your `rails server` command. You may have to update your gems by running `bundle install`, but Rails will tell you about it if you must.
+
+The output of your `rails server` command tells you which URL to visit on your browser to see your brand new prismic.io Rails application.
+
+### Configuring
+
+By default, the starter kit uses the public API of the "Les Bonnes Choses" repository; its endpoint is `https://lesbonneschoses.prismic.io/api`. You may want to start by editing the `config/prismic.yml` file to make your Rails application points to your prismic.io repository.
+
+To get the OAuth configuration working, go to the Applications panel in your repository settings, and create an OAuth application to allow interactive sign-in. Just create a new application, fill the application name and the callback URL (localhost URLs are always authorized, so at development time you can omit to fill the Callback URL field), and copy/paste the clientId & clientSecret tokens into the `config/prismic.yml` file.
+
### Licence
This software is licensed under the Apache 2 license, quoted below.
File renamed without changes.

0 comments on commit 8c1ea8a

Please sign in to comment.