smart-answers
Ruby HTML Other
Latest commit 28c2632 Dec 1, 2016 @leenagupte leenagupte committed on GitHub Merge pull request #2827 from alphagov/update-plek-content-store-url
Update plek content store url
Permalink
Failed to load latest commit information.
app Create a template for marriage-abroad title in Italy Nov 28, 2016
bin Fix Style/ExtraSpacing violations Apr 19, 2016
config Remove gds_api_adapters config Nov 7, 2016
db Initial blank rails app. Oct 27, 2011
doc Update plek content store url Dec 1, 2016
lib Update affecting all same marriages in Australia Nov 30, 2016
log Initial blank rails app. Oct 27, 2011
public Remove dangling symlinks Aug 13, 2012
script Update COD slug in marriage-abroad Oct 21, 2016
test Update affecting all same marriages in Australia Nov 30, 2016
vendor Fix js errors in chrome 35 May 27, 2014
.gitignore Don't track coverage directory Jun 29, 2012
.rubocop.yml Remove .rubocop_todo.yml and related documentation Jun 1, 2016
.ruby-version Bump ruby to 2.3.1 Oct 25, 2016
CONTRIBUTING.md Merge pull request #2013 from alphagov/update-documentation-about-con… Oct 15, 2015
Gemfile Add minitest-focus gem Nov 7, 2016
Gemfile.lock Add minitest-focus gem Nov 7, 2016
LICENSE.md Correct attribution of copyright Mar 11, 2015
README.md Update the Rummager rake task name on the README Sep 29, 2016
Rakefile Change the way logging works for test Sep 22, 2016
app.json Update plek content store url Dec 1, 2016
config.ru Fix Style/ExtraSpacing violations Apr 19, 2016
install.sh Use content store for breadcrumbs, sidebar & metadata Nov 4, 2016
jenkins.sh Move environment variables to test helper Nov 3, 2016
jenkins_branches.sh Add jenkins_branches.sh Apr 2, 2014
startup.sh Add a handy script to start up the app in development. Feb 2, 2012
startup_heroku.sh Change plek service content store uri Nov 11, 2016

README.md

Smart Answers

Smart answers are a great tool for content designers to present complex information in a quick and simple way. Defining what they are – decision trees? calculators? tools? is immaterial – what they do is provide a reusable technical framework to build a quick and simple answer to a complex question.

Read more in Lisa Scott's GDS blog post.

Deploy

Screenshots

Student Finance Forms screenshot

Live examples

Nomenclature

  • Smart Answer: The flow, questions and outcomes.

  • Flow: Defines the questions, outcomes and the rules for navigating between them.

  • Landing page: Contains a description of the Smart Answer and the "Start now" button that leads to the first question.

  • Question page: Contains an individual question that's asked in order to help arrive at at an outcome.

  • Outcome page: Contains the result of the Smart Answer based on responses to individual questions.

Technical documentation

This is a Ruby on Rails application that contains:

  • A Rails application to serve Smart Answers
  • A DSL for creating Smart Answers
  • The Smart Answers that appear on GOV.UK

NOTE. This application doesn't use a database and as such it does not include the ActiveRecord Railtie in application.rb.

Dependencies

  • alphagov/static: provides static assets (JS/CSS) and the GOV.UK templates.
  • nodejs/node: provides JS runtime for precompiling assets for deployment

Running the application

See:

Running the test suite

$ bundle exec rake

Smart Answers

 Smart Answer flow development

Smart Answers app development

Debugging

Registering on GOV.UK

  • bundle exec rake panopticon:register will send smart answers to panopticon. Panopticon will register the URL.

Search indexing

  • bundle exec rake rummager:index will send the data to Rummager for indexing in search.

Licence

MIT License