added tests and fixed functions which failed
added note about this project and links to other resources
modified links from markdown to rst