Added stats API docs (bug 908409)

Anyone picky about English want to review this for me? @cvan?