Removed comments marking api as likely to change
Reworded documentation areas such as summary
More consistency in javascript method documentation