changed error to alert to make it easier to notice
documentation improvements and typos fixed