var
  ask = require('askr').ask,
  questions;
 
questions = {};
 
// Simple required question
//
// Hello there!
// What's your name?
questions.name = {
  text: 'Hello there!\nWhat\'s you name? ',
  required: true
};
 
// This question won't be called as the answer is already provided
// Useful when you gather some data before hand and want to ask more questions
// to fill in missing answers.
questions.age = {
  text: 'How old are you?'
};
 
// A question with options
// Will output the options at the end of the question into parenthesis
// separated by a comma.
// {{{options}}} in the text of the question to customise the display of the
// options.
// optionsSeparator to change the separator.
//
// Would you rather live in Paris or San Francisco?
questions.travel = {
  text: 'Would you rather live in {{{options}}}? ',
  optionsSeparator: ' or ',
  options: [
    'Paris',
    'San Francisco'
  ]
};
 
// A question with a default answer
// Will output the default at the end of the questions into brackets unless you
// provide a template with {{{default}}} in the text of the question.
//
// Do you like askr? [yes]
questions.like = {
  text: 'Do you like askr?',
  default: 'yes'
};
  
ask(questions, {age: 24}, function (err, answers) {
  // Do something with the answers
});

var questions = {
  q1: { ... },
  q2: { ... },
  ...
};

var question = {
  text: 'Question body ',
  required: true,
  optionsSeparator: ',',
  options: ['y', 'n'],
  default: 'n'
};

'Question body ({{{options}}}) [{{{default}}}] ';

ask(questions, callback);
ask(questions, givenAnswers, callback);

var callback = function (err, answers) {
  ...
};