Updated ngAria API Docs and Developer Guide

This PR contains updates to the ngAria API documentation as well as the Developer Guide.

@caitp @btford the more thorough examples and explanations are in the Developer Guide: is there enough detail in the API doc portion?