reflect the new changes in django app; better documentation