stormpath · cilim · Nov 8, 2016 · Sep 20, 2016 · Sep 20, 2016 · Sep 20, 2016
diff --git a/.gitignore b/.gitignore
@@ -12,4 +12,4 @@ spec/dummy/db/development.sqlite3
 spec/dummy/log/development.log
 spec/dummy/log/test.log
 spec/dummy/tmp
-docs
+docs/_build
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "docs/_themes/stormpath"]
+	path = docs/_themes/stormpath
+	url = https://github.com/stormpath/stormpath-sphinx-theme.git
diff --git a/.travis.yml b/.travis.yml
@@ -21,7 +21,7 @@ after_success:
 - if [ "$CURRENT_HASH" = "$RELEASE_HASH" ]; then DEPLOY_DOCS=true; fi
 env:
   global:
-  - STORMPATH_APPLICATION_URL=https://api.stormpath.com/v1/applications/4BiS1Hc1LuBEbszdDrOwyz
+  - STORMPATH_APPLICATION_URL=https://api.stormpath.com/v1/applications/4xz3y2Hrid4aqp5YwbNTvk
   - secure: VMjIMI42vIPTMPTr0fnzSPiIjzuSAnT7iNWjhAXP9WsdaCmxwHp1vOlry4QuX8DzpKHv2MQubeUN/UA227Nk1xn+CVu9mujWOqvvjmL9m20wMJvwT4ctn7zG+FJK76id9TEyx0mCTlH4ZrRoDMGfM9yzhpsg8FtSebBDdHxePaM=
   - secure: IhR6H9qxmxCDNbLK0ebYuIXQRsGA/JhD6In4V/hnSMJ8lPi2kwRn6eKclNCHGNjcy6QF1V5vddKIfKOkFFZvIyP26reygTX1g5Mfa8SqTGKh3DAW4WP+T+yaE4z4UBDK1zZpbV0Zbkw/HC0xeD8UPnjRzERX1LVZp1qeEjhQrks=
   - secure: a5woUmOQPRW6FBQBaxKJATfggUD/BVTBfeRaS07u1SQOpMoGJZLY0m29PVx4fHwRD1E7ho31YIeH8wk1vMMrimIHSdE1B4pm4n8bUTi/gDFwavXq9KgTdH8f6Eli37nAXZum78m4NgL9+OlrKeJKCcROdzniZPvFaLrnOwBGzVs=
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -17,10 +17,13 @@ Released on Nov 02, 2016
 Version 2.0.2
 -------------
 Released on Aug 29, 2016
+
 - Render path links depending on the configuration
 - Use Faker to generate random test data
 - Rename all user instances to account
 
+Version 2.0.1
+-------------
 Released on Aug 22, 2016
 
 - Fix error when showing new_register_path on login page when register is disabled.
diff --git a/docs/Makefile b/docs/Makefile
@@ -0,0 +1,225 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  applehelp  to make an Apple Help Book"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  epub3      to make an epub3"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+	@echo "  coverage   to run coverage check of the documentation (if enabled)"
+	@echo "  dummy      to check syntax errors of document sources"
+
+.PHONY: clean
+clean:
+	rm -rf $(BUILDDIR)/*
+
+.PHONY: html
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+.PHONY: dirhtml
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+.PHONY: singlehtml
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+.PHONY: pickle
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+.PHONY: json
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+.PHONY: htmlhelp
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+.PHONY: qthelp
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Rails-Stormpath.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Rails-Stormpath.qhc"
+
+.PHONY: applehelp
+applehelp:
+	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
+	@echo
+	@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
+	@echo "N.B. You won't be able to view it unless you put it in" \
+	      "~/Library/Documentation/Help or install it in your application" \
+	      "bundle."
+
+.PHONY: devhelp
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/Rails-Stormpath"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Rails-Stormpath"
+	@echo "# devhelp"
+
+.PHONY: epub
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+.PHONY: epub3
+epub3:
+	$(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3
+	@echo
+	@echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3."
+
+.PHONY: latex
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+.PHONY: latexpdf
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+.PHONY: latexpdfja
+latexpdfja:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+.PHONY: text
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+.PHONY: man
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+.PHONY: texinfo
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+.PHONY: info
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+.PHONY: gettext
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+.PHONY: changes
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+.PHONY: linkcheck
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+.PHONY: doctest
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+.PHONY: coverage
+coverage:
+	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
+	@echo "Testing of coverage in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/coverage/python.txt."
+
+.PHONY: xml
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+.PHONY: pseudoxml
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
+
+.PHONY: dummy
+dummy:
+	$(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy
+	@echo
+	@echo "Build finished. Dummy builder generates no files."
diff --git a/docs/_static/facebook-new-project.png b/docs/_static/facebook-new-project.png
diff --git a/docs/_static/facebook-url-settings.png b/docs/_static/facebook-url-settings.png
diff --git a/docs/_static/forgot-change.png b/docs/_static/forgot-change.png
diff --git a/docs/_static/forgot-complete.png b/docs/_static/forgot-complete.png
diff --git a/docs/_static/forgot-email-sent.png b/docs/_static/forgot-email-sent.png
diff --git a/docs/_static/forgot-email.png b/docs/_static/forgot-email.png
diff --git a/docs/_static/forgot-init.png b/docs/_static/forgot-init.png
diff --git a/docs/_static/forgot.png b/docs/_static/forgot.png
diff --git a/docs/_static/github_create_app.png b/docs/_static/github_create_app.png
diff --git a/docs/_static/google-enable-login.png b/docs/_static/google-enable-login.png
diff --git a/docs/_static/google-new-project.png b/docs/_static/google-new-project.png
diff --git a/docs/_static/google-oauth-settings.png b/docs/_static/google-oauth-settings.png
diff --git a/docs/_static/id-site-login.png b/docs/_static/id-site-login.png
diff --git a/docs/_static/id-site-settings.png b/docs/_static/id-site-settings.png
diff --git a/docs/_static/id-site-stormpath-config.png b/docs/_static/id-site-stormpath-config.png
diff --git a/docs/_static/linkedin-add-authorized-urls.gif b/docs/_static/linkedin-add-authorized-urls.gif
diff --git a/docs/_static/linkedin-add-permissions.gif b/docs/_static/linkedin-add-permissions.gif
diff --git a/docs/_static/linkedin-new-application.gif b/docs/_static/linkedin-new-application.gif
diff --git a/docs/_static/linkedin-permissions-page.png b/docs/_static/linkedin-permissions-page.png
diff --git a/docs/_static/login-page-basic.png b/docs/_static/login-page-basic.png
diff --git a/docs/_static/login-page-facebook-permissions.png b/docs/_static/login-page-facebook-permissions.png
diff --git a/docs/_static/login-page-facebook.png b/docs/_static/login-page-facebook.png
diff --git a/docs/_static/login-page-google-account.png b/docs/_static/login-page-google-account.png
diff --git a/docs/_static/login-page-google.png b/docs/_static/login-page-google.png
diff --git a/docs/_static/login-page-linkedin.png b/docs/_static/login-page-linkedin.png
diff --git a/docs/_static/login-page.png b/docs/_static/login-page.png
diff --git a/docs/_static/login_page_with_all_providers.png b/docs/_static/login_page_with_all_providers.png
diff --git a/docs/_static/registration-page-basic.png b/docs/_static/registration-page-basic.png
diff --git a/docs/_static/registration-page-error.png b/docs/_static/registration-page-error.png
diff --git a/docs/_static/registration-page.png b/docs/_static/registration-page.png
diff --git a/docs/_static/verification-complete.png b/docs/_static/verification-complete.png
diff --git a/docs/_static/verification-email.png b/docs/_static/verification-email.png
diff --git a/docs/_static/verification.png b/docs/_static/verification.png
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
@@ -0,0 +1,6 @@
+{% extends "!layout.html" %}
+
+{% block footer %}
+  {{ super() }}
+  <script src="//cdn.optimizely.com/js/225847041.js"></script>
+{% endblock %}
diff --git a/docs/_themes/stormpath b/docs/_themes/stormpath
diff --git a/docs/about.rst b/docs/about.rst
@@ -0,0 +1,72 @@
+.. _about:
+
+About
+=============================
+
+Are you building a web app, but not sure if the Stormpath Rails Gem is right for you?  This page will help you decide if it is a good fit!
+
+
+What is Stormpath?
+------------------
+
+`Stormpath`_ is a reliable, scalable API service for managing users, authentication and authorization. Stormpath allows your web application to do things like:
+
+- Create user accounts.
+- Edit user accounts.
+- Store custom user data with each account.
+- Create groups and roles.
+- Automate account email verification and password reset email workflows.
+- Assign users various permissions (groups, roles, etc.).
+- Handle complex authentication and authorization patterns.
+- Log users in via social login with `Facebook`_ and `Google`_ OAuth.
+- Cache user information for quick access.
+- Scale your application as you get more users.
+- Securely store your users and user data in a central location.
+- Support token-based authentication for your Single Page Applications (SPAs)
+- Allow users to authenticate with your application with OAuth
+- and more!
+
+Stormpath provides a simple REST API for all of the above.  For instance, if you wanted to create a new user account given an email address and password, you could send Stormpath an ``HTTP POST`` request and Stormpath would create a new user account for you, securely hash its password using security best practices and and store it securely on Stormpath's cloud service.
+
+In addition to allowing you to create users and groups, Stormpath also allows you to store custom data with each user account.  Let's say you want to store a user's birthday -- you can send Stormpath an ``HTTP POST`` request to the user's account URL and store *any* variable JSON data (birthdays, images, movies, links, etc.).  This information is encrypted and authenticated end-to-end, ensuring your user data is secure.
+
+What is the Stormpath Rails Gem?
+------------------------------------------
+
+The Stormpath Rails Gem is a gem that makes it *incredibly* simple to add user management and authentication to your Ruby on Rails web application.
+
+It aims to completely abstract away all user registration, login, authentication and authorization workloads as well as properly secure the web app.  It is completely flexible - use only the functionality you need or leverage the entire feature set.
+
+
+Who should use Stormpath?
+-------------------------
+
+Stormpath is a powerful and secure service, but might not be for everyone.
+
+You might want to use Stormpath if:
+
+- You want to make user creation, management, and security as simple as possible (you can get started with the Stormpath Rails Gem with ZERO lines of code *excluding settings*)
+- User security is a top priority.  The Stormpath API, our documents and integrations were built by Java security experts.
+- Scaling your userbase is a potential problem (Stormpath handles scaling your users transparently).
+- You need to store custom user data along with your user's basic information (email, password).
+- You would like to have automatic email verification for new user accounts.
+- You would like to configure and customize password strength rules.
+- You'd like to keep your user data separate from your other applications to increase platform stability / availability.
+- You are building a service oriented application or using a microservices based architecture, in which multiple independent services need access to the same user data.
+- You who would like to use Stormpath, but need to host it yourself (Stormpath has private and on-premise editions you can use internally).
+
+**Stormpath is a great match for applications of any size where security, development speed, and simplicity are top priorities.**
+
+You might **NOT** want to use Stormpath if:
+
+- You are building an application that does not need user accounts.
+- Your application is meant for internal employee-only usage (not exposed to the public web).
+- You aren't worried about user data / security much.
+- You aren't worried about application availability / redundancy.
+- You want to roll your own custom user authentication.
+
+Want to use Stormpath?  OK, great!  Let's get started!
+
+.. _Stormpath: https://stormpath.com/
+.. _Facebook: https://www.facebook.com/
+.. _Google: https://www.google.com/