This file gives a brief guide to the Answers Module.

Last Updated: 3/31/11 by Chip Cleary

This module is based on:
	The original D5 "answers" module written by Amanuel Tewolde.
	The original D6 conversion of that module written by Inders Singh
	The original features version of the module written by Greg Harvey
	The updated features version of the module written by me.


What the module does:
	The module can display a list of all questions. This is available at the path 'questions'
	When viewing the list of questions, viewers can sort it by title, post date, and page views
	When displaying a question, the system shows all the answers to that question. 

There are 4 relevant roles (these are not drupal system roles but rather types of users for the module):
	Viewers: Those who view questions and answers
	Askers: Those who ask a question.
	Answerers: Those who answer a question
	Administrator: Those who have the "administer settings" privilege and who can set up the module

Viewer Role:
	Users can view a list of questions:
    - All questions: 'questions' or 'questions\all'
	- Unanswered questions: 'questions\uanswered'
	Users can view an individual question along with its responses.

In the D6 version, viewers can also do vote on responses. This is not yet implemented in D7.
	Users can vote a question thumbs up or thumbs down is he has permission.

Asker Role:
	Users can ask a new question if they have permission. They can do so at 'node/add/question' or by using the Create Content -> Question menu item
	When a user asks a new question, the user can specify whether they want to be notified by email when an answer is posted. This is a checkbox setting on the form used to create the question.

Answerer Role:
	When viewing a question, a user can enter a new answer if he has permission. This is done by using the 'Post an Answer' link on the question node view.

Administrator Role: Administrators can define:
	Which drupal system roles can view questions and answers (by setting the permission 'access content')
	Which drupal system roles can ask a new question (by setting the  permission 'create question content')
	Which drupal system roles can answer questions (by setting the permission 'create answer content')
	Whether users can edit or delete their own or others questions and answers (by setting the corresponding permissions)
	The subject and body templates for an email notification (using the path 'admin/settings/answers')

In the D6 version, Administrators can also set these two permissions. However, voting is not yet implemented in the D7 version:
	Which drupal system roles can vote responses up/down (by setting the permission 'use vote up/down on nodes')
	Which drupal system roles can see the tally of up/down votes(by setting the permission 'use vote up/down on nodes')


To set up the module:
	Install the module
	Configure the administration options (see "Administrator Role" above)

A few pointers on how it works:
	The module was developed using the Features module
	It defines two CCK types: Question and Answer
	It defines a couple of views: all_questions and question answers
	It defines a couple of strongarm variables: 'answers_answer_notification_subject' and 'answers_answer_notification_body'
	It employs a small amount of custom code to:
		Provide administrative settings
		Send notification emails
