updated docs to be completely accurate again
added django 1.5 and up compatibility