bunch of doc changes for how (new) apps will work