adding some docs -- but clear that web frameworks needs to be first order consideration