/**
 * Password authentication service.
 *
 * This component provides an HTTP service that authenticates an end-user using
 * a username and password.
 *
 * This service is intended to be used by web applications where HTML forms are
 * used to present the end-user with an interactive interface for logging in to
 * the application.  The interface is rendered by the web browser being used by
 * the end-user.  After authentication, a login session is established, allowing
 * the user to continue navigating the application in an authenticated state.
 *
 * @param {Function|Function[]} promptHandler - Prompt handler.
 * @param {Function|Function[]} verifyHandler - Verify handler.
 * @returns {Function}
 */
exports = module.exports = function(promptHandler, verifyHandler) {
  var express = require('express');
  
  var router = new express.Router();
  router.get('/', promptHandler);
  router.post('/', verifyHandler);
  
  return router;
};

exports['@provides'] = 'http://i.bixbyjs.org/http/Service';
exports['@path'] = '/login/password';
exports['@require'] = [
  './handlers/prompt',
  './handlers/verify'
];

@@ -193,56 +193,44 @@
  by 
-web applications where HTML forms are%0A * used to
+sites making use of HTML forms to%0A *
  pre
@@ -259,20 +259,8 @@
  an 
-interactive 
 inte
@@ -286,33 +286,26 @@
 n to
-%0A *
  the 
-application
+site
 .  The
+%0A *
  int
@@ -355,19 +355,16 @@
  used by
-%0A *
  the end
@@ -376,16 +376,19 @@
 .  After
+%0A *
  authent
@@ -436,19 +436,16 @@
 allowing
-%0A *
  the use
@@ -457,16 +457,19 @@
 continue
+%0A *
  navigat
@@ -480,19 +480,12 @@
 the 
-application
+site
  in 

Clarify docs.