adding south initial migration, raising meaningful errors when settings property is missing, cleaning up settings property names, updated the README