added tests; and more improvements to the API.
added release notes url to the spec